{
  "openapi": "3.1.0",
  "info": {
    "title": "Jithin Rajiv public MCP API",
    "version": "1.0.0",
    "description": "Public read-only MCP JSON-RPC endpoint. No authentication, API key or OAuth scopes are required. Purchases happen on Gumroad."
  },
  "servers": [
    {
      "url": "https://jithinrajiv.com"
    }
  ],
  "security": [],
  "paths": {
    "/mcp": {
      "post": {
        "operationId": "sendMcpMessage",
        "summary": "Send an MCP JSON-RPC message",
        "description": "Supports initialize, ping, tools/list and tools/call. Tools: list_templates, get_template, list_blog_posts, get_current_offer. Notifications receive HTTP 202 without a body. JSON-RPC errors may use HTTP 200.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Request"
              },
              "examples": {
                "initialize": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 1,
                    "method": "initialize",
                    "params": {
                      "protocolVersion": "2025-06-18",
                      "capabilities": {},
                      "clientInfo": {
                        "name": "catalog-client",
                        "version": "1.0"
                      }
                    }
                  }
                },
                "listTools": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 2,
                    "method": "tools/list"
                  }
                },
                "listTemplates": {
                  "value": {
                    "jsonrpc": "2.0",
                    "id": 3,
                    "method": "tools/call",
                    "params": {
                      "name": "list_templates",
                      "arguments": {
                        "type": "all"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "JSON-RPC result or error.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "jsonrpc": {
                      "const": "2.0"
                    },
                    "id": {
                      "type": [
                        "string",
                        "number",
                        "null"
                      ]
                    },
                    "result": {},
                    "error": {
                      "type": "object"
                    }
                  },
                  "required": [
                    "jsonrpc",
                    "id"
                  ]
                }
              }
            }
          },
          "202": {
            "description": "Notification accepted; no response body."
          },
          "400": {
            "description": "Invalid JSON; JSON-RPC parse error."
          },
          "403": {
            "description": "Browser origin is not allowed."
          },
          "408": {
            "description": "Request body timed out."
          },
          "413": {
            "description": "Request exceeds 64 KiB."
          },
          "415": {
            "description": "Content-Type must be application/json."
          },
          "429": {
            "description": "Per-process request rate limit exceeded.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "Seconds before retrying."
              }
            }
          }
        }
      },
      "options": {
        "operationId": "mcpCorsPreflight",
        "summary": "CORS preflight",
        "responses": {
          "204": {
            "description": "Allows POST and OPTIONS from any origin."
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Request": {
        "type": "object",
        "required": [
          "jsonrpc",
          "method"
        ],
        "properties": {
          "jsonrpc": {
            "const": "2.0"
          },
          "id": {
            "type": [
              "string",
              "number",
              "null"
            ]
          },
          "method": {
            "type": "string",
            "enum": [
              "initialize",
              "ping",
              "tools/list",
              "tools/call",
              "notifications/initialized"
            ]
          },
          "params": {
            "type": "object",
            "additionalProperties": true
          }
        },
        "additionalProperties": true
      }
    }
  }
}
