OnePlatform MCP Server
The server lets you search/read OnePlatform developer documentation and API operation contracts; with OnePlatform keys, it adds scoped API tools for many business verticals.
Search OnePlatform docs with
docs_search, returning relevant pages and URLs.Fetch a documentation page as Markdown with
docs_get_pageby path or URL.Look up an exact API operation contract by
operationIdwithapi_get_operation.The provided schema exposes only these no-key documentation tools; API tools require
ONEPLATFORM_APP_KEYandONEPLATFORM_USER_KEY.With keys, README describes toolsets for account, payments, withdrawals, subscriptions, terminal, invoicing, shipping, sites, analytics, email, domains, telemetry, sales, agents, calendar, social, tasks, and studio.
It supports read operations plus limited confirmed writes (e.g., payment links, subscriptions/plans/customers, terminal requests, calendar visits, social scheduling, tasks); withdrawals/domains are read-only, and money movement, fiscal issuance, admin, credentials, and webhooks are excluded.
Toolsets can be limited via
ONEPLATFORM_TOOLSETSorX-OnePlatform-Toolsets; QA is default, and it runs locally over stdio or hosted over HTTP.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OnePlatform MCP Server search the OnePlatform docs for how to cancel a payment link"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP de OnePlatform
Conecta un agente de código a la documentación de OnePlatform y a la OnePlatform API con sus propias claves, en QA por defecto.
Herramientas
Tres herramientas de documentación funcionan sin claves: docs_search, docs_get_page y api_get_operation. Con
claves, el servidor suma las de la API, agrupadas por vertical (toolset):
Toolset | Qué puede hacer el agente |
| Perfil, historial de saldo, consumo, comercios y avisos. Siempre activo: de acá sale el |
| Links de pago (listar, ver, crear y cancelar) y transacciones |
| Saldo retirable, movimientos, retiros, métodos de retiro (enmascarados) y cobros que pueden pasar al saldo retirable (sólo lectura) |
| Planes, suscripciones y clientes del comercio; crear, editar, publicar y archivar planes, crear y editar clientes, emitir una invitación y cancelar una suscripción |
| Solicitudes de terminal de tarjetas, su estado y el detalle de un pago con terminal; crear, corregir y retirar una solicitud (el envío y los documentos siguen en el panel) |
| Facturas electrónicas (sólo lectura: el MCP no emite ni anula) |
| Envíos (sólo lectura: el MCP no despacha) |
| Sitios, artículos, trabajos de generación, categorías y rendimiento en buscadores |
| Estado, propiedad, flujos, dimensiones, eventos clave, etiqueta y métricas de analítica; estado, cuentas, ingresos, alertas y problemas de políticas de anuncios; sitios, mapas e instantáneas de mapas de calor (sólo lectura) |
| Remitentes, plantillas, cuota y mensajes del correo transaccional; conversaciones del correo del negocio |
| Dominios, disponibilidad, precios, transferencias y registros de correo (sólo lectura) |
| Proyectos, errores, último evento, logs, rendimiento y uso; marcar un error como resuelto o ignorado |
| Preparación, canales, ofertas, prospectos, tablero y reporte del embudo |
| Agentes, catálogo, herramientas, presupuesto, ejecuciones y acciones pendientes; detener una ejecución |
| Calendario, visitas, horarios libres, asesores y enlaces de reserva; agendar, mover, reasignar, completar y cancelar una visita; obtener el enlace de reserva de un registro o el propio de una oferta (sin revocar el vigente) |
| Configuración, portafolios, cuentas conectadas, publicaciones, calendario, comentarios, analítica y aprobaciones; crear y editar un borrador, programar (o mandar a aprobación), mover y cancelar una publicación |
| Tareas, subtareas, bandeja de subtareas disponibles y archivos; crear, editar y asignar tareas, crear subtareas y tomar o completar una subtarea |
| Catálogo de plantillas, pedidos, piezas entregadas y sus enlaces, deudas y presentadores del estudio creativo (sólo lectura) |
Por defecto se listan todos. Para un cliente que admite pocas herramientas, elija las verticales que usa:
ONEPLATFORM_TOOLSETS=pagos,envios (local) o la cabecera X-OnePlatform-Toolsets: pagos,envios (alojado).
Las escrituras (en negrita) no cobran saldo en el acto, no emiten documentos fiscales ni mueven dinero, y el cliente
pide confirmación antes de ejecutarlas. Dos excepciones conocidas, iguales a las del panel: agendar, mover o cancelar
una visita dispara los avisos de la agenda a la persona y al asesor, y programar una publicación la deja en cola para
salir en la red en la fecha elegida, cuando se cobra (cancelarla antes no cobra nada). Publicar ya, aprobar, responder
comentarios, encargar piezas del estudio y pagar quedan fuera del MCP. En redes las herramientas trabajan sobre el portafolio
propio de la persona: el MCP no reenvía la cabecera para actuar en un portafolio ajeno. La lista exacta está en
tools.manifest.json y lo que nunca puede exponerse, en denylist.json:
administración, credenciales, webhooks, cobros, emisión fiscal y movimientos de dinero. En retiros y dominios sólo se
permiten lecturas.
Related MCP server: Litport MCP server
Uso local (stdio)
ONEPLATFORM_APP_KEY=ak-XXXX… ONEPLATFORM_USER_KEY=sk-XXXX… npx -y @oneplatformlabs/mcpVariable | Valor |
| Clave de aplicación ( |
| Clave de usuario ( |
|
|
| Opcional: verticales a listar, separadas por comas (por defecto, todas) |
Instalación por cliente: https://developer.1platform.pro/docs/saas/1platform-api/integrar-con-ia
Uso alojado (HTTP)
node dist/cli.js --http sirve Streamable HTTP sin estado en POST /mcp y GET /healthz. Las claves llegan en
X-OnePlatform-App-Key y X-OnePlatform-User-Key en cada solicitud; el entorno lo fija ONEPLATFORM_ENV al arrancar.
Límites: 30 solicitudes por minuto por IP, 120 por par de claves y 256 KiB por cuerpo.
URL | API |
| QA |
| Producción |
El entorno lo decide la URL; ninguna cabecera o parámetro lo cambia.
claude mcp add --transport http oneplatform https://mcp-qa.1platform.pro/mcp \
--header "X-OnePlatform-App-Key: $ONEPLATFORM_APP_KEY" \
--header "X-OnePlatform-User-Key: $ONEPLATFORM_USER_KEY"Despliegue
Variable | Valor |
| URL interna del API del mismo entorno ( |
| Saltos públicos de confianza además de los privados ( |
La IP del cliente se resuelve detrás de Cloudflare y del front door con un port del resolver del API
(src/http/client-address.ts, vectores compartidos en
test/vectors/client-address.json). Esa IP limita al cliente en el MCP y viaja
al API como única entrada de X-Forwarded-For, escrita de nuevo y nunca copiada de la solicitud: el contenedor
llama al API por la red privada de Docker, así que el API cuenta un balde por cliente.
Esa red es mcp-net-{qa,prod}: la crea el compose del Core con subred explícita y sólo el API y este
contenedor están en ella (hasta #6 el MCP compartía la red del motor de telemetría). Por eso el Core se
despliega antes: sin la red, el up falla y el deploy vuelve a la imagen anterior. Una rama vieja del Core
en QA saca al API de la red hasta que traiga main.
deploy/compose.{qa,prod}.yml y deploy/remote-deploy.sh (comando forzado de la llave
de despliegue: <qa|prod> <sha de main> o <qa|prod> rollback); el workflow Deploy hosted MCP despliega QA y
luego producción en cada push a main cuando la variable MCP_DEPLOY_ENABLED vale true.
Vigencia de la documentación
Las herramientas de documentación leen llms.txt, los Markdown y el OpenAPI publicados por el portal,
con caché de diez minutos. El portal debe publicar su contrato actualizado para que api_get_operation
lo entregue; instalar de nuevo el paquete MCP no corrige una especificación atrasada en el portal.
npm run check:docs-freshness compara rutas, operaciones, esquemas y autenticación del portal con la API viva.
Falla ante diferencias o errores de descarga, sin respaldo silencioso; cada descarga tiene 120 s y un
solo reintento ante error de red o tiempo agotado (no ante HTTP de error). Ignora prosa y ejemplos saneados;
no sustituye la revisión editorial. Ya no corre en GitHub Actions: se ejecuta en local (/local-checks, npm run check:docs-freshness).
Para verificar un portal candidato, configure ONEPLATFORM_DOCS_OPENAPI_URL con su OpenAPI; para un
banco local también puede configurar ONEP_API_OPENAPI_URL. No se imprimen esas URLs.
La generación de herramientas (fetch-openapi y check:tools) usa directamente el OpenAPI público de la API.
Así, una copia atrasada en el portal no puede ocultar cambios de las herramientas ejecutables. La allowlist,
los toolsets y los límites de escritura siguen en tools.manifest.json y denylist.json.
Available Tools
3 toolsapi_get_operationARead-only
Devuelve el contrato exacto de una operación de la OnePlatform API (método, ruta, parámetros, cuerpo, respuestas y códigos de error) a partir de su operationId. No necesita claves.
Inputs: operationId (required).
docs_get_pageARead-only
Devuelve una página de la documentación de OnePlatform en Markdown. Acepta la ruta de la página (por ejemplo /docs/saas/1platform-api/links-de-pago) o su URL. No necesita claves.
Inputs: path (required).
docs_searchARead-only
Busca en la documentación de OnePlatform para desarrolladores y devuelve las páginas más relevantes con su URL en Markdown. No necesita claves.
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools occupy clearly separate niches: free-text documentation search, direct documentation page retrieval by path/URL, and exact API operation contract lookup by operationId. Search vs. fetch is a well-understood pair, and the API-reference tool is a distinct resource entirely. No two tools could plausibly be confused for one another.
All names follow a strict {domain}_{action} snake_case pattern (docs_search, docs_get_page, api_get_operation), with clear domain prefixes distinguishing documentation from API concerns. Verb choice is consistent and readable throughout.
Three tools is a tight, purposeful surface with no redundancy, and each covers a genuinely different retrieval need. It sits at the low end of comfortable scope, leaving some room for additional reference operations, but nothing feels padded.
Documentation search, page fetch, and operation lookup cover the core reference workflow, but there is no way to enumerate or list available API operations, so api_get_operation depends entirely on the caller already knowing an operationId (or the docs surfacing it). No listing/browsing or discovery operation is a notable gap for an API-reference server.
Maintenance
Related MCP Connectors
Read-only search and Markdown pages from the OpenPlanr docs, for coding agents.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Access and search Branch's official API documentation directly within any AI agent or client.
Gemmein docs, API reference, error explainers and a live integration check for coding agents.
Related MCP Servers
AlicenseDqualityBmaintenanceEnables agents to access live DeFi, social intelligence, risk, and API documentation tools with a caller-supplied API key.242327 npmMIT
Litport MCP serverofficial
AlicenseNot gradedqualityCmaintenanceEnables coding agents and chat clients to inspect proxy tokens, usage, pools, geo targeting, and build ready-to-use proxy connection URLs via the Litport account API, while remaining read-only.81 npmMIT- AlicenseAqualityBmaintenanceEnables a coding agent to get short, token-efficient answers about a project through grouped searches, focused symbol or section reads, and bounded read-only script output, with safety limits on paths, secrets, commands, and response size.3MIT
- AlicenseNot gradedqualityCmaintenanceEnables coding agents to search public documentation, retrieve SDK snippets with verification status, and access published pricing and an llms.txt resource in a read-only, credential-free way.MIT