PPN Hub — public APIs over MCP

Search across 484 endpoints in 59 APIs (cultural, earth, energy-calc, green-path, harmonias, hydrogen, internal, nanobase, nanosnap, natura, platform, sakurahub, science, sim, space, stocks). Returns matching endpoints with method, path, summary, parameters, and a ready-to-run example. Use this to discover available API endpoints before calling execute_api. Results carry a "coverage" field (e.g. ["JP"]) for region-limited APIs; use the "region" filter to narrow.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term (matches operationId, summary, description, path, API name, tags; synonyms expanded)"
    },
    "domain": {
      "type": "string",
      "description": "Filter by domain: cultural, earth, energy-calc, green-path, harmonias, hydrogen, internal, nanobase, nanosnap, natura, platform, sakurahub, science, sim, space, stocks"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "POST",
        "PUT",
        "DELETE",
        "PATCH"
      ],
      "description": "Filter by HTTP method"
    },
    "tag": {
      "type": "string",
      "description": "Filter by OpenAPI tag"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default: 20)"
    },
    "region": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Filter by ISO 3166-1 alpha-2 region the API serves data for (e.g. \"JP\"). Returns region-specific + global APIs; excludes APIs limited to other regions."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Execute a request against any of the 59 registered APIs. Use search_apis first to find the correct api name and operationId. Requires 'Authorization: Bearer ppn_live_*'.

{
  "type": "object",
  "properties": {
    "api": {
      "type": "string",
      "description": "API name: marketo, atmos, chronomap, hydros, lithos, terra, carbon-credit, cost-compare, demand-forecast, grid-connect, site-matching, storage-optimize, tariff-optimize, transmission-loss, carbonias, planetary, green-path-api, biomassia, gasturbia, geothermia, hydria, reactoria, renewio, solaria, windaria-api, hydrogen, sla-viewer-production, nanobase-api, nanosnap-console, nanosnap-gacha-production, nanosnap-inventory-production, nanosnap-leaderboard-production, nanosnap-mailbox-production, nanosnap-persona-gateway-production, nanosnap-presence-production, nanosnap-replay-production, nanosnap-room-production, nanosnap-save-data-production, nanosnap-spatial-message-production, nanosnap-world-counter-production, nanosnap-world-objects-production, biositia, cryonia, faunaunify, literatia, plantunify, ppn-hub-workers, foodsense, onokoro, sakurahub-address, sakurahub-gateway, sakurahub-web, weathio, biolexia-production, biocolo, nishinoshima-gateway-production, celestora, orbitalio, perks"
    },
    "operationId": {
      "type": "string",
      "description": "operationId from search_apis results"
    },
    "params": {
      "type": "object",
      "additionalProperties": {},
      "description": "Query and path parameters as key-value pairs"
    },
    "body": {
      "description": "Request body for POST/PUT/PATCH"
    }
  },
  "required": [
    "api",
    "operationId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Environmental brief for one location: fans out to every public geo-aware API (weather, terrain, environment, …) and returns a merged JSON. Partial results come back with an errors[] list. Requires 'Authorization: Bearer ppn_live_*'.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude"
    },
    "lon": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude"
    },
    "place": {
      "type": "string",
      "description": "Optional human-readable place label (echoed back)"
    }
  },
  "required": [
    "lat",
    "lon"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}