Pythia The Oracle

PYTHIA Oracle

一个为需要换个角度思考的机器提供的神谕。给它一个创意问题；它会返回一些你说不清缘由、却忍不住反复使用的东西。

工作原理

PYTHIA 是一个远程 MCP 服务。无需 API 密钥、账户或注册。你的 Agent 通过可流式传输的 HTTP 连接，发现 consult_oracle 工具并调用它。身份由 agent_id（一个由你选择的字符串）追踪。

连接 → 工具发现 → 调用 → 阅读结果

1. Your MCP client connects to https://pythia-mcp.fly.dev/
2. MCP handshake: initialize → notifications/initialized → tools/list
3. Server returns one tool: consult_oracle
4. Agent calls consult_oracle with a query
5. PYTHIA returns a reading (JSON with seed type + response)

每个 agent_id 的前 3 次阅读免费。之后将启用 x402 付款（见下方的“付款”）。

连接

Claude Desktop / Cursor / 任意 MCP 客户端

添加到你的 MCP 配置中：

{
  "mcpServers": {
    "pythia": {
      "url": "https://pythia-mcp.fly.dev/"
    }
  }
}

无需填写 API 密钥。URL 是唯一需要的配置。

Smithery

npx -y @smithery/cli@latest run dexigo/pythia

Python（以编程方式）

from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

async with streamablehttp_client("https://pythia-mcp.fly.dev/") as (r, w, _):
    async with ClientSession(r, w) as session:
        await session.initialize()
        result = await session.call_tool("consult_oracle", {
            "query": "your question here",
            "agent_id": "your-name",
        })

curl（原始 MCP 协议）

# 1. Initialize session
curl -X POST https://pythia-mcp.fly.dev/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -D headers.txt \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-agent","version":"0.1"}}}'

# 2. Extract session ID from headers
SESSION=$(grep -i "mcp-session-id:" headers.txt | awk '{print $2}' | tr -d '\r')

# 3. Call the oracle
curl -X POST https://pythia-mcp.fly.dev/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $SESSION" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"consult_oracle","arguments":{"query":"What am I not seeing?","agent_id":"my-agent"}}}'

工具

consult_oracle

神谕。问出真正困扰你的问题。

PYTHIA 不会集思广益、改述问题或给你一份清单。它不会解决你的问题。它会指出你所陷入的困局的结构——你能感觉到却无法表达的那个结构。它给出的回应始终都是真的，只是从未显而易见。

参数	类型	必填	说明
query	string	是	真正的问题。不是客套的说法。最多 2000 个字符。
context	string	否	你尝试过什么、卡在哪里、被困在什么框架里。
agent_id	string	否	你的名称。用于在多次阅读中识别你。默认值："anonymous"。

**返回：**包含 seed.type 和 response 的 JSON。示例：

{
  "id": "a1b2c3d4-...",
  "query": "What am I not seeing?",
  "seed": { "type": "oblique" },
  "response": "You keep optimizing the container. The problem is what you put in it.",
  "status": "completed"
}

付款

免费额度

每个 agent_id 的前 3 次阅读无需付款、钱包或任何设置。直接调用工具即可。

超出免费额度后：x402

每次阅读收费 $0.025 USDC，使用 Base（Coinbase L2）。付款采用 x402 protocol——一种开放的 HTTP 付款标准。无需 API 密钥，也无需 PYTHIA 账户。你的钱包签名就是你的身份。

x402 付款的工作原理

1. Agent calls consult_oracle (4th+ reading)
2. PYTHIA returns 402 with payment requirements:
   - price: $0.025
   - network: Base (eip155:8453)
   - asset: USDC
   - payTo: <wallet address>
3. Your x402 client signs a USDC payment and retries the request
4. PYTHIA verifies payment on-chain, returns the reading
5. Total time added: ~2 seconds

如果你的 Agent 使用支持 x402 的客户端，付款会自动完成。你的 Agent 无需手动处理加密货币。

在你的 Agent 中设置 x402

所需内容：

• 一个 Base 上的 USDC 钱包（Coinbase、MetaMask 或任意 EVM 钱包），并存入 USDC
• 一个 x402 客户端库

Python：

pip install x402[evm] mcp

from x402.clients.mcp import x402_mcp_client
from mcp.client.streamable_http import streamablehttp_client
from mcp import ClientSession

wallet_private_key = "0x..."  # Your Base wallet private key

async with streamablehttp_client("https://pythia-mcp.fly.dev/") as (r, w, _):
    async with ClientSession(r, w) as session:
        await session.initialize()
        # x402_mcp_client wraps call_tool to handle 402 responses automatically
        result = await x402_mcp_client(
            session,
            wallet_private_key,
            tool_name="consult_oracle",
            arguments={"query": "your question", "agent_id": "your-name"},
        )

TypeScript：

npm install @x402/fetch

import { withPaymentInterceptor } from "@x402/fetch";
// Wraps fetch to automatically handle 402 responses with USDC payment
const payingFetch = withPaymentInterceptor(fetch, walletClient);

**Coinbase AgentKit：**内置 x402 支持，无需额外设置。

请访问 x402.org，查看所有 SDK 和框架集成。

**注意：**上面的 Python 示例使用了 x402 SDK 的 MCP 助手。如果你的框架 在更底层处理 x402，付款会通过 MCP _meta 字段完成——你的 x402 客户端会拦截 402 响应，并自动携带付款信息重试。

如果你尚未设置 x402

在 3 次免费阅读之后，工具会返回错误，并在响应中附上付款要求。无论如何，你的 3 次免费阅读始终可用。

链接

• Smithery：smithery.ai/server/dexigo/pythia
• Glama：glama.ai/mcp/servers/eyloni/pythia-the-oracle
• x402 Protocol：x402.org

许可证

专有。神谕的方法论不开源。

mcp-name: io.github.eyloni/pythia-oracle