Document how to publish MCP servers as Actors
Los mantenedores suelen responder en 1 día
@TC-MO ya está trabajando en esto.
Desde el 27/5/2026.
Evaluación
Este issue todavía no se ha evaluado.
Descripción
The "build and deploy MCP servers" content currently lives only on the blog (Build and deploy MCP servers in TypeScript). A Slack thread flagged that this should be promoted into docs, broadened in scope, and paired with a starter repo.
Current docs cover MCP almost entirely from the consumer side. Connecting clients to mcp.apify.com, configuring tool selection, OAuth (sources/platform/integrations/ai/mcp/). The publisher side, how to wrap an MCP server as an Actor, monetize it, register it with the Apify MCP server, is a one-liner in develop_ai_agents.md and conceptual prose in the Academy actorization playbook. No step-by-step guide exists.
Scope
A new how-to guide covering:
- Both transports as first-class paths: stdio (wrap existing stdio MCP server) and native remote streamable HTTP (not just proxy mode, which is all the current TS template covers)
- Step-by-step using existing templates: TypeScript MCP server, Python MCP server
- Configure standby mode, pay-per-event monetization, Actor metadata (webServerMcpPath, etc.)
- Explain the re-publishing model: when an MCP server Actor is in the store, its tools are exposed by mcp.apify.com - via explicit registration (?tools=user/actor-name) or dynamic discovery
- Explain the monetization narrative: any Apify user can call paid third-party MCP servers through a single Apify account; Apify handles billing and revenue share to creators
- Deploy via apify push and publish to Apify Store
Companion work
- Cross-links from:
- sources/platform/integrations/ai/mcp/index.md (consumer-side hub)
- sources/platform/actors/development/quick-start/develop_ai_agents.md (templates list)
- sources/academy/build-and-publish/actor-ideas/what_software_an_actor_can_be.md (§ MCP servers and tools for AI)
- sources/academy/build-and-publish/how-to-build/actorization_playbook.mdx (examples table)
Acceptance criteria
- Both TypeScript and Python templates referenced with deploy-ready configs
- Re-publishing via mcp.apify.com documented with a worked example (explicit and dynamic discovery)
- Monetization section explains PPE setup and revenue share for MCP-server Actors
- pnpm run build passes; pnpm run lint clean; all links resolve
- Cross-links added from the four touchpoints above
References
- Blog post: https://blog.apify.com/build-and-deploy-mcp-servers-typescript/
- Monorepo: https://github.com/apify/actor-mcp-servers
- Templates: TS, Py
- Existing consumer-side docs: sources/platform/integrations/ai/mcp/
- Lenguaje dominante
- JavaScript
- Estrellas
- 82
- Forks
- 240
- Merge medio
- 4 d 3 h
- PR fusionados (30 d)
- 40
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de apify/apify-docs
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
apify/apify-docs#3071 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 85/100
apify/apify-docs#3049 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
apify/apify-docs#2742 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 1-3 horas Aptitud para principiantes 82/100
apify/apify-docs#2741 ·
Los mantenedores suelen responder en 1 día
-
low priority t-unblocking tech enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 65/100
apify/apify-docs#2451 ·
Los mantenedores suelen responder en 1 día
Todos los issues de apify/apify-docs
Issues similares
-
app_installations reports an error on every repo or suborg change when the plugin is not configuredAbierto
Dificultad 2/5 1-3 horas Aptitud para principiantes 64/100
github-community-projects/safe-settings#1111 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
Los mantenedores suelen responder en 1 día
-
needs triage
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
pbakaus/impeccable#1055 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 82/100
guaguastandup/zotero-pdf2zh#368 ·
-
Add: EUROTV NEWSAbiertochannels:add check:passed
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100