PostcodeContext.UK

{
  "$schema": "https://a2a-protocol.org/schemas/v1/agent-card.json",
  "name": "PostcodeContext.UK",
  "description": "Comprehensive Great Britain Postcode & Outcode Intelligence API covering England, Scotland, and Wales. Provides ONS Census 2021 demographics, Indices of Deprivation deciles (English IoD 2025, Scottish SIMD 2020, Welsh WIMD 2025), Land Registry property metrics, Ofcom broadband speeds, and spatial proximity to schools and healthcare.",
  "version": "1.0.0",
  "provider": {
    "organization": "PostcodeContext.UK",
    "url": "https://api.postcodecontext.uk"
  },
  "documentation": {
    "home": "https://api.postcodecontext.uk",
    "llms_txt": "https://api.postcodecontext.uk/llms.txt",
    "openapi_json": "https://api.postcodecontext.uk/openapi.json",
    "data_dictionary": "https://api.postcodecontext.uk/data-dictionary",
    "attribution": "https://api.postcodecontext.uk/api/v1/attribution"
  },
  "supportedInterfaces": [
    {
      "url": "https://api.postcodecontext.uk/mcp",
      "protocolBinding": "JSONRPC",
      "protocolVersion": "2024-11-05",
      "description": "Model Context Protocol (MCP) streamable HTTP interface"
    },
    {
      "url": "https://api.postcodecontext.uk/api/v1",
      "protocolBinding": "REST",
      "protocolVersion": "1.0",
      "description": "HTTP REST API with x402 payment settlement"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false
  },
  "securitySchemes": [
    {
      "type": "x402",
      "scheme": "exact",
      "network": "eip155:8453",
      "token": "USDC",
      "tokenContract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "recipient": "0x8ab7568ac097523e81a94644235fcf19a2b85670",
      "pricing": {
        "single_postcode": "$0.005 USDC",
        "outcode_district": "$0.005 USDC",
        "compare_postcodes": "$0.010 USDC",
        "batch_enrichment": "$0.050 USDC"
      }
    }
  ],
  "skills": [
    {
      "id": "get_postcode_intelligence",
      "name": "Get Postcode Intelligence",
      "description": "Returns full socio-economic, housing, broadband, demographic, and educational context for any Great Britain unit postcode.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "compare_gb_postcodes",
      "name": "Compare Postcodes",
      "description": "Directly contrasts 2 to 5 Great Britain postcodes across affluence, safety, housing cost, broadband, and family suitability.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    },
    {
      "id": "enrich_postcodes_batch",
      "name": "Enrich Postcodes Batch",
      "description": "Bulk demographic, economic, and spatial lookup for up to 50 Great Britain postcodes.",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_outcode_district_summary",
      "name": "Get Outcode District Summary",
      "description": "High-level summary of an entire outward code district (e.g., SW1A, BB7, EH1, CF10).",
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json",
        "text/markdown"
      ]
    }
  ]
}