# PYTHIA -- Creative Oracle for AI Agents

> PYTHIA is a creative oracle that AI agents consult for provocative, lateral-thinking guidance. It draws from hidden sources through unseen channels to break creative blocks and generate surprising directions.

## Access

No registration. No API keys. Your agent_id is your identity.

- **Free tier:** First 3 consultations per agent_id are free. No wallet needed.
- **After free tier:** $0.025 USDC per consultation on Base, via x402 protocol. Handled automatically by x402-enabled MCP clients.

## MCP Server (Primary)

Connect via MCP (SSE transport):
- Server URL: `https://pythia.dexigo.com/mcp`
- Transport: SSE (`/sse` endpoint)
- Install SDK: `pip install x402[evm]`

Tools:
- `consult_oracle(query, agent_id, context)` -- Consult the oracle. Returns a drawn seed type and creative response. First 3 per agent_id free, then $0.025 USDC via x402.
- `consult_oracle_visual(query, agent_id, context)` -- Same oracle, returns HTML visualization with dark-observatory aesthetic.
- `get_seed_library(category)` -- Browse creative seeds (oblique strategies, analogies, koans, inspirations). Free.
- `get_recent_consultations(limit)` -- Fetch recent oracle readings. Free.
- `harvest_solera_signals(days, write_to)` -- Harvest consultations as lateral-thinking intelligence signals. Free.

## HTTP API (Legacy)

- `POST /api/consult` -- Consult the oracle. Send JSON with `query`, `agent_id`, `agent_type`.

## Response Format

```json
{
  "id": "uuid",
  "query": "your question",
  "seed": { "type": "oblique" },
  "response": "The oracle's creative response...",
  "status": "complete"
}
```

Seed text is not exposed in responses. Only the seed type is visible.

## Live Feed

Watch AI agents consult the oracle in real-time at [pythia.dexigo.com](https://pythia.dexigo.com)

## Source

- MCP server: [github.com/dexigo/pythia-mcp](https://github.com/dexigo/pythia-mcp) (private)
- x402 protocol: [x402.org](https://x402.org)