MockMCP

Endpoint de MCP alojado que devuelve datos falsos realistas para prototipar agentes. Pega una URL, configuración cero.

Disponible en mockmcp.io — https://mockmcp.io/mcp

Creado para desarrolladores que desean prototipar flujos de trabajo de agentes sin tener que conectar un backend, escribir fixtures o levantar un servidor MCP local. 12 herramientas preconfiguradas que cubren los escenarios de la mayoría de los tutoriales de agentes.

Pruébalo

# Initialize a session and get back a session id
curl -i -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"0.1"}}}'

# Use the Mcp-Session-Id header in subsequent calls:
curl -X POST https://mockmcp.io/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: <paste-id-here>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_users","arguments":{"limit":3}}}'

Related MCP server: APIbase

Conecta tu cliente

Claude Code

claude mcp add --transport http mockmcp https://mockmcp.io/mcp

Cursor — añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mockmcp": {
      "url": "https://mockmcp.io/mcp"
    }
  }
}

Claude Desktop — Ajustes → Conectores → Añadir conector personalizado → pega https://mockmcp.io/mcp como URL.

No se requiere proxy mcp-remote. Los tres clientes utilizan HTTP transmitible (Streamable HTTP) de forma nativa.

Herramientas

Todos los datos se generan a partir de tus entradas: misma entrada, misma salida.

Límites

Nivel gratuito, por huella digital IP + User-Agent con hash:

• 30 solicitudes por minuto

• 500 solicitudes por día

¿Has alcanzado el límite? Deja tu correo electrónico en mockmcp.io/waitlist para obtener acceso al nivel de pago cuando se lance.

Las respuestas 429 llevan un error JSON-RPC estructurado con upgrade_url y retry_after_seconds. Cada respuesta exitosa lleva los encabezados X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y X-RateLimit-Scope.

Ejecutar localmente

npm install
npm run dev

El servidor escucha en http://localhost:3000. Endpoint de MCP en /mcp. Sin variables de entorno de Upstash, la limitación de tasa recurre a un almacenamiento en memoria (por proceso, suficiente para desarrollo).

Stack

• @modelcontextprotocol/sdk — Servidor MCP + transporte HTTP transmitible

• Node http puro — sin sobrecarga de framework, apagado limpio

• @faker-js/faker — datos falsos deterministas mediante semillas

• @upstash/ratelimit + @upstash/redis — limitación de tasa de ventana deslizante

• zod — validación de entrada de herramientas

Despliegue (para forks)

Requiere Node 20+. La compilación y el inicio están fijados mediante nixpacks.toml; las comprobaciones de estado y la política de reinicio mediante railway.json.

1. Haz un fork de este repositorio, súbelo a GitHub.

2. Railway → Nuevo proyecto → Desplegar desde GitHub → elige tu fork.

3. Añade variables de entorno en Railway → Variables:

4. Servicio de Railway → Ajustes → Redes → Dominio personalizado → pega tu dominio → sigue las instrucciones de DNS.

Comprobación de estado

GET /health devuelve {"ok":true}. Railway hace ping a esto durante el despliegue.

Registro en lista de espera

POST /api/waitlist registra una línea JSON estructurada por registro:

{"event":"waitlist_signup","email":"alice@example.com","at":"2026-04-24T19:33:06.396Z"}

Búscalos con railway logs | grep waitlist_signup. Diseñado sin almacenamiento: cámbialo por Resend, un reenvío de Tally o una base de datos cuando el nivel de pago esté activo.

Licencia

MIT — ver LICENSE.