A deterministic Model Context Protocol server over Streamable HTTP: initialize, tools (with structured output and deliberate failures), resources, resource templates and prompts — plus a token-protected variant for 401 handling.
Base URL: https://funapi.dev/api/mcp/v1 · 3 endpoints · OpenAPI 3.1 spec and Postman collection available. New here? Read the getting started guide.
JSON-RPC endpoint
GET /mcp/v1/info — How to connect, and what this server exposes · Responds with 200 Link to this endpointPOST /mcp/v1/mcp — Streamable HTTP endpoint (JSON responses): initialize, tools, resources, prompts, ping · Responds with 200 202 400 405 Link to this endpointBearer-protected variant
POST /mcp/v1/secure/mcp — Same server behind a Bearer token (mcp-test-token) — test 401 handling · Responds with 200 401 Link to this endpointThe MCP Test Server is a hosted, deterministic Model Context Protocol server for testing MCP clients, agents and inspectors over the Streamable HTTP transport. It answers initialize with a session id, lists tools with input and output schemas, returns structured content, exposes resources, a resource template and a prompt, and has tools that fail on purpose — as a tool error the model sees, or as a JSON-RPC error the client must handle.
GET https://funapi.dev/api/mcp/v1/info — How to connect, and what this server exposes. No token, no signup:
curl -i https://funapi.dev/api/mcp/v1/info
Response: 200 OK
{
"name": "Fun API MCP Test Server",
"transport": "Streamable HTTP (JSON responses, no server-initiated stream)",
"url": "https://funapi.dev/api/mcp/v1/mcp",
"secureUrl": "https://funapi.dev/api/mcp/v1/secure/mcp",
"secureToken": "mcp-test-token",
"protocolVersions": [
"2025-11-25",
"2025-06-18",
"2025-03-26",
"2024-11-05"
],
"tools": [
"echo",
"add",
"get_time",
"lookup_user",
"fail",
"slow"
],
"resources": [
"funapi://readme",
"funapi://status-codes"
],
"prompts": [
"write_api_test"
],
"inspector": "npx @modelcontextprotocol/inspector → Transport: Streamable HTTP → URL above"
}
Last updated