llms.txt Content
# 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)