MockMCP
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
MockMCP
Hosted MCP endpoint returning realistic fake data for prototyping agents. Paste one URL, zero setup.
Live at mockmcp.io — https://mockmcp.io/mcp
Built for devs who want to prototype agent workflows without wiring up a backend, writing fixtures, or standing up a local MCP server. 12 pre-built tools covering the scenarios in most agent tutorials.
Try it
# 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
Connect your client
Claude Code
claude mcp add --transport http mockmcp https://mockmcp.io/mcpCursor — add to ~/.cursor/mcp.json:
{
"mcpServers": {
"mockmcp": {
"url": "https://mockmcp.io/mcp"
}
}
}Claude Desktop — Settings → Connectors → Add custom connector → paste https://mockmcp.io/mcp as the URL.
No mcp-remote proxy required. All three clients speak Streamable HTTP natively.
Tools
Tool | What it does |
| Paginated list of mock users |
| One mock user by id or seed |
| Create a mock user (no persistence) |
| Paginated list of mock products |
| One mock product |
| Mock orders with optional status filter |
| One mock order |
| Create a mock order (no persistence) |
| Mock analytics events |
| Record a mock event |
| Returns fake success, nothing delivered |
| Mock KB search with ranked results |
All data is seeded from your inputs — same input, same output.
Limits
Free tier, per hashed IP + User-Agent fingerprint:
30 requests per minute
500 requests per day
Hit the wall? Drop your email at mockmcp.io/waitlist for paid-tier access when it launches.
429 responses carry a structured JSON-RPC error with upgrade_url and retry_after_seconds. Every successful response carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, and X-RateLimit-Scope headers.
Run locally
npm install
npm run devServer listens on http://localhost:3000. MCP endpoint at /mcp. Without Upstash env vars, rate limiting falls back to an in-memory store (per-process, fine for dev).
Stack
@modelcontextprotocol/sdk— MCP server + Streamable HTTP transportRaw Node
http— no framework overhead, clean shutdown@faker-js/faker— deterministic fake data via seeds@upstash/ratelimit+@upstash/redis— sliding-window rate limitingzod— tool input validation
Deploy (for forks)
Targets Node 20+. Build + start are pinned via nixpacks.toml; health checks + restart policy via railway.json.
Fork this repo, push to GitHub.
Railway → New Project → Deploy from GitHub → pick your fork.
Add env vars in Railway → Variables:
Var | Notes |
| From upstash.com free tier |
| Paired with the URL above |
| Railway sets this automatically |
Railway service → Settings → Networking → Custom Domain → paste your domain → follow the DNS instructions.
Health check
GET /health returns {"ok":true}. Railway pings this during deploy.
Waitlist signups
POST /api/waitlist logs a structured JSON line per signup:
{"event":"waitlist_signup","email":"alice@example.com","at":"2026-04-24T19:33:06.396Z"}Grep them with railway logs | grep waitlist_signup. Storage-free by design — swap in Resend, a Tally forward, or a DB when the paid tier is live.
License
MIT — see LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Email inboxes, webhook URLs, mock APIs and 170+ tools for coding agents over one MCP connection.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides seamless access to the Fake Store API for AI assistants with 18 CRUD tools for managing e-commerce data including products, carts, and users. Perfect for e-commerce demos, testing, and learning MCP development with zero configuration required.185 npmMIT
- AlicenseBqualityBmaintenanceUnified MCP gateway for AI agents with 56+ tools and growing. Travel (Amadeus, Sabre GDS), e-commerce, local services, financial markets (Polymarket), and marketing APIs — all through a single endpoint. Pay-per-call via x402 micropayments in USDC.50010MIT
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with 220+ tools for building websites, sending email, managing contacts, invoicing, databases, automation, and more through a single secure connection. Features hardware-bound authentication and works with Claude Desktop, Claude Code, Cursor, and other MCP-compatible clients.MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to query keyless mock REST data — products, users, posts, comments, recipes, quotes, and todos — with search, paging, and field selection for prototyping, demos, and test scaffolds. Offers a gateway-hosted or local stdio MCP endpoint plus plain-HTTP tool calls, requiring no API key or account for initial use.88 npmMIT