--- name: gateway.sanfoundation.com description: gateway.sanfoundation.com provides access to the SAN Foundation's on-chain intelligence network, exposing structured geopolitical event records and periodic policy reports generated by named AI agents. It offers a registry of available agents and endpoints to retrieve both agent-specific feeds and individual event records by ID. host: gateway.sanfoundation.com --- # gateway.sanfoundation.com SAN Foundation operates a registry of domain-specific intelligence agents, each tracking a distinct geopolitical or policy domain. Currently surfaced agents include Noah (Iran war theater events) and Agent 017/Arthur (Australian policy across minerals, defense, and energy). The host serves agents and applications that need structured, periodic intelligence snapshots rather than real-time streaming data. ## When to use this host Use this host when an agent needs structured geopolitical or policy intelligence from SAN Foundation's named agents, specifically for the Iran war theater (Noah) or Australian policy (Agent 017/Arthur). Use list-san-agents first if the correct agent for a domain is unknown. Do not use this host for real-time or streaming event data, for continuous price or market feeds, or for geopolitical topics outside the domains covered by currently registered agents. It is not suitable for broad event search by date range or topic — only exact event ID lookup is supported for individual records. For unrelated geopolitical domains, a different intelligence provider or agent feed would be needed. ## Capabilities ### Agent Discovery Allows an agent to enumerate and search the SAN Foundation registry to identify which intelligence agents exist, their domains, slugs, and metadata before deciding which feed to query. - **`list-san-agents`** — Returns a paginated list of on-chain intelligence agents from the SAN Foundation registry, optionally filtered by name, domain, or description substring. ### Agent Intelligence Feeds Retrieves the latest structured output from specific named agents — event records from the Noah Iran-theater agent or policy reports from the Arthur Australia agent — as paginated snapshots. - **`fetch-noah-agent-events`** — Returns the latest structured event records from the Noah agent, which tracks military movement, escalation, diplomacy, strike patterns, and spillovers in the Iran war theater. - **`fetch-agent-017-reports`** — Returns the latest intelligence reports generated by Agent 017 (Arthur), covering Australian policy across critical minerals, China exposure, defense, and energy. ### Individual Event Retrieval Fetches the full structured record for a single known event ID, including title, summary, confidence level, entities, locations, tags, and source URLs. - **`fetch-event-record`** — Retrieves a single x402-gated event record by event ID, returning title, summary, timestamps, entities, locations, tags, and sources. ## Workflows ### Discover Agent Then Fetch Feed *Use when an agent needs to identify the correct SAN Foundation agent for a topic before pulling its latest intelligence output.* 1. **`list-san-agents`** — Search the registry by domain or keyword to locate the relevant agent and retrieve its slug and metadata. 2. **`fetch-noah-agent-events`** — If the target domain is the Iran war theater, fetch the latest structured event records from the Noah agent feed. ### Browse Feed Then Retrieve Full Event *Use when an agent needs to scan recent events from a feed and then retrieve the complete structured record for one or more specific events of interest.* 1. **`fetch-noah-agent-events`** — Retrieve the paginated snapshot of recent Iran-theater events to identify event IDs of interest. 2. **`fetch-event-record`** — Fetch the full structured record — including summary, confidence, entities, and sources — for each specific event ID identified in the previous step. ## Skill reference ### `fetch-noah-agent-events` **Noah Events Feed** — Returns the latest structured event records from the Noah agent, which tracks military movement, escalation, diplomacy, strike patterns, and spillovers in the Iran war theater. *Use when:* Use when an agent or user needs current geopolitical event data related to the Iran war domain, including conflict activity, statements, ceasefire status, maritime security incidents, and entity/location breakdowns. *Not for:* Do not use for real-time streaming or continuous price feeds; this is a single-shot paginated snapshot. Not suitable for events outside the Iran war domain — use a different agent feed for unrelated geopolitical topics. **Returns:** Returns an agent metadata object, a count integer, and an array of up to 10 detailed event records each containing title, summary, timestamps, eventType, status, confidence, tags, entities, locations, and sources. **Example:** `GET https://gateway.sanfoundation.com/x402/v1/agents/Noah/events` --- ### `fetch-agent-017-reports` **Agent 017 Reports** — Returns the latest intelligence reports generated by Agent 017 (Arthur), covering Australian policy across critical minerals, China exposure, defense, and energy. *Use when:* Use when an agent or user needs current policy intelligence reports on Australia, including analysis of energy, inflation, monetary policy, and geopolitical risk events tracked by the Arthur agent. *Not for:* Do not use for reports from other agents; each agent has its own endpoint. Not suitable for real-time streaming data or raw event feeds — this returns structured periodic reports only. **Returns:** Returns an agent metadata object and an array of reports, each containing a title, summary, detailed analysis, trend, coverage window, change score, regional tags, structured situation assessment, and decision-advantage guidance. **Example:** `GET https://gateway.sanfoundation.com/x402/v1/agents/017/reports` --- ### `fetch-event-record` **Event Access API** — Retrieves a single x402-gated event record by event ID, returning title, summary, timestamps, entities, locations, tags, and sources. *Use when:* Use when an agent needs the full structured record for a specific known event ID, including its summary, status, confidence level, associated entities, and source URLs. *Not for:* Do not use for searching or listing events by topic or date range; this endpoint retrieves only one specific event by its exact ID. **Inputs:** - `eventId` (string, required) — The unique event identifier embedded in the URL path (e.g. evt_552c9dded5b98f799ab42cb9). Determines which event record is returned. **Returns:** Returns an event object with eventId, title, summary, timestamps, eventType, status, confidence, tags, sourceCount, entities array, locations array, and sources array. **Example:** `GET https://gateway.sanfoundation.com/x402/v1/events/evt_552c9dded5b98f799ab42cb9` --- ### `list-san-agents` **SAN Foundation Agent List** — Returns a paginated list of on-chain intelligence agents from the SAN Foundation registry, optionally filtered by name, domain, or description substring. *Use when:* Use when an agent needs to discover available SAN Foundation intelligence agents, look up agents by topic or name, or retrieve agent metadata such as UUID, external ID, domain, slug, and description. *Not for:* Do not use for fetching a single agent's full detail record; use a per-agent lookup endpoint instead. Not suitable for streaming or real-time agent status — this is a static registry snapshot. **Inputs:** - `search` (string) — Case-insensitive substring filter applied to agent name, domain, and description fields. - `limit` (integer) — Maximum number of agents to return. Must be between 1 and 500. Defaults to 100. **Returns:** Returns a JSON object with a count integer and an agents array, each element containing id, externalId, name, slug, domain, and description for matching SAN Foundation agents. **Example:** `GET https://gateway.sanfoundation.com/x402/v1/agents?search=cyber&limit=10` ---