Pythia The Oracle

PYTHIA Oracle

既成概念にとらわれず考える必要がある機械のためのオラクルです。創造的な問題を投げかけると、うまく説明できないのに使わずにはいられない答えを返します。

仕組み

PYTHIA はリモート MCP サーバーです。API キーもアカウントも登録も必要ありません。エージェントはストリーミング可能な HTTP 経由で接続し、consult_oracle ツールを見つけて呼び出します。ID は 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

1 回の回答につき、Base（Coinbase L2）で $0.025 USDC がかかります。支払いには x402 プロトコル を使用します。これはオープンな HTTP 決済標準です。API キーは不要です。PYTHIA のアカウントも不要です。ウォレット署名があなたの ID になります。

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

エージェントが x402 対応クライアントを使用している場合、この処理は自動的に行われます。エージェントが暗号資産を手動で扱う必要はありません。

エージェントで 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 のサポートが組み込まれています。追加設定は不要です。

すべての SDK とフレームワーク連携については、x402.org をご覧ください。

注： 上記の 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 プロトコル： x402.org

ライセンス

プロプライエタリです。オラクルの手法はオープンソースではありません。

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