MCP Test Server

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.

server

JSON-RPC endpoint

auth

Bearer-protected variant

The 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.

What you can practise here

Example request and response

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"
}

Open and run this endpoint

All 55 mock REST APIs

Use this response elsewhere

Last updated