{ "openapi": "3.0.1", "info": { "title": "MCP Server for AI Agents: Discourse Forum Search & Threads", "description": "Standby MCP Server (/mcp) and batch Actor for AI agents to search public Discourse forums, list latest and top topics, and extract full discussion threads, categories and accepted answers as clean text. No proxy, no login.", "version": "0.1", "x-build-id": "cedylR5DsReMfwL8k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mutualistic_housing~discourse-forum-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mutualistic_housing-discourse-forum-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/mutualistic_housing~discourse-forum-mcp/runs": { "post": { "operationId": "runs-sync-mutualistic_housing-discourse-forum-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/mutualistic_housing~discourse-forum-mcp/run-sync": { "post": { "operationId": "run-sync-mutualistic_housing-discourse-forum-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "search", "latest", "top", "thread", "categories" ], "type": "string", "description": "search = full-text search (needs query); latest = newest topics; top = top topics for the period; thread = full threads for topic_ids; categories = category list of each forum.", "default": "search" }, "query": { "title": "Search query", "type": "string", "description": "Required when mode = search (up to 200 characters). Supports Discourse search syntax such as tags:mcp or status:solved. Ignored by the other modes.", "default": "mcp server" }, "forums": { "title": "Forums", "type": "array", "description": "Preset keys (openai, huggingface, discourse, python, rust, pytorch, cloudflare, n8n, obsidian, julia, golang, kubernetes, flyio, render, homeassistant) or public Discourse domains/https URLs. 1 to 10 forums. Empty means discourse.", "default": [ "discourse" ], "items": { "type": "string" } }, "topic_ids": { "title": "Topic IDs or URLs", "type": "array", "description": "Mode thread only (1 to 50 entries): numeric topic ids (bound to the first forum) or full topic URLs such as https://meta.discourse.org/t/some-topic/12345.", "items": { "type": "string" } }, "period": { "title": "Top period", "enum": [ "daily", "weekly", "monthly", "quarterly", "yearly", "all" ], "type": "string", "description": "Time window for mode top.", "default": "weekly" }, "include_thread_posts": { "title": "Include thread posts in search results", "type": "boolean", "description": "Mode search only: attach thread_posts (clean text) to search results for up to 25 distinct topics.", "default": false }, "max_posts_per_thread": { "title": "Max posts per thread", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum posts returned per thread (1 to 100).", "default": 20 }, "max_items": { "title": "Max items", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of result items to return (and be charged for), 1 to 500.", "default": 25 }, "max_total_charge_usd": { "title": "Max total charge (USD)", "minimum": 0, "type": "number", "description": "Hard spending cap for this run; results are truncated so the charge never exceeds it." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }