{
  "$schema": "https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json",
  "version": "1.0",
  "protocolVersion": "2025-06-18",
  "serverInfo": {
    "name": "stampidentifierapp-public",
    "title": "Stamp Identifier App Public MCP",
    "version": "1.0.0"
  },
  "description": "Read-only MCP endpoint for searching famous stamp profiles and retrieving collector guidance from stampidentifierapp.com.",
  "documentationUrl": "https://stampidentifierapp.com/developers/api",
  "iconUrl": "https://stampidentifierapp.com/images/logo.png",
  "transport": {
    "type": "streamable-http",
    "endpoint": "/api/mcp"
  },
  "capabilities": {
    "tools": {
      "listChanged": false
    }
  },
  "authentication": {
    "required": false,
    "schemes": []
  },
  "tools": [
    {
      "name": "search_stamps",
      "title": "Search Stamps",
      "description": "Search the public stamp catalog by keyword and optional country filter.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Keyword, stamp name, catalog number, country, or theme to search for."
          },
          "country": {
            "type": "string",
            "description": "Optional exact country filter, such as 'United States' or 'Great Britain'."
          },
          "limit": {
            "type": "integer",
            "description": "Optional maximum number of results to return, between 1 and 25.",
            "minimum": 1,
            "maximum": 25
          }
        },
        "required": [
          "query"
        ]
      },
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "get_stamp_profile",
      "title": "Get Stamp Profile",
      "description": "Fetch the full profile for a specific stamp using its slug.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The canonical stamp slug, such as 'penny-black' or 'inverted-jenny'."
          }
        },
        "required": [
          "slug"
        ]
      },
      "annotations": {
        "readOnlyHint": true
      }
    },
    {
      "name": "get_collector_guide",
      "title": "Get Collector Guide",
      "description": "Return the most relevant educational pages for identification, value, and product questions.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "annotations": {
        "readOnlyHint": true
      }
    }
  ],
  "instructions": "Use search_stamps to find matching profiles, get_stamp_profile for full structured detail, and get_collector_guide for educational entry points.",
  "website": "https://stampidentifierapp.com"
}