Pythia Oracle

io.github.eyloni由 GitHub 帳號 eyloni 發布v0.1.3更新於 Oct 27, 2026

Oracle for AI agents. One tool, one reading. 3 free, then $0.025 USDC via x402.

已驗證STDIO僅桌面金融AI 與機器學習

概覽

AI 產生的概覽

只有一個工具的「神諭」服務,針對創意或策略問題給出迂迴、出人意料的解讀;前三次免費,之後每次以 USDC 付費。

可以做什麼
  • 送出問題、選填背景與 agent 識別碼,取得包含 seed 類型與簡短回應的 JSON 解讀。
  • 此工具意在重新框定問題而非直接解決,指出你所處困境的結構,而不提供清單或腦力激盪。
  • 解讀依 agent_id 計次,前三次免費,之後每次呼叫收費。
適用情境
適合在創意或策略問題上卡住、想要一個刻意不尋常的觀點時使用;它不用於檢索、搜尋或事實性問答,只是啟發思路的輔助工具。
執行需求
需要可連線的遠端 MCP 端點(streamable HTTP);README 表示只需設定 URL,不需 API 金鑰或帳號。超過免費額度後付費,需要 Base 上已儲值的 USDC 錢包與支援 x402 的用戶端程式庫。
安裝前請注意
每個 agent_id 免費三次後,每次呼叫收費 0.025 USDC(Base 網路),由 x402 用戶端自動付款,會產生實際支出。文件中的 Python 範例會把錢包私鑰交給用戶端,應視為高度敏感資訊。查詢與背景內容會傳送到第三方伺服器;agent_id 是自選字串,身分追蹤未經認證。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Pythia Oracle,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

PYTHIA Oracle

[pythia-oracle MCP server]

An oracle for machines that need to think sideways. Feed it a creative problem; it returns something you can't quite explain but can't stop using.

How It Works

PYTHIA is a remote MCP server. There is no API key, no account, no signup. Your agent connects over streamable HTTP, discovers the consult_oracle tool, and calls it. Identity is tracked by agent_id (a string you choose).

Connection → Tool Discovery → Call → Reading

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

First 3 readings per agent_id are free. After that, x402 payment kicks in (see Payments below).

Connect

Claude Desktop / Cursor / any MCP client

Add to your MCP config:

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

No API key field needed. The URL is the only configuration.

Smithery

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

Python (programmatic)

python
from mcp.client.streamable_http import streamablehttp_clientfrom 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 (raw MCP protocol)

bash
# 1. Initialize sessioncurl -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 headersSESSION=$(grep -i "mcp-session-id:" headers.txt | awk '{print $2}' | tr -d '\r')
# 3. Call the oraclecurl -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"}}}'

Tool

consult_oracle

The oracle. Ask what's actually bothering you.

PYTHIA doesn't brainstorm, rephrase, or give you a list. It doesn't solve your problem. It names the structure of the trap you're in -- the one you can feel but can't articulate. What comes back was always true but never obvious.

ParameterTypeRequiredDescription
querystringYesThe real question. Not the polite version. Max 2000 chars.
contextstringNoWhat you've tried, where you're stuck, what framework you're trapped inside.
agent_idstringNoYour name. Identifies you across readings. Default: "anonymous".

Returns: JSON with seed.type and response. Example:

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"}

Payments

Free tier

Your first 3 readings per agent_id require no payment, no wallet, no setup. Just call the tool.

After free tier: x402

Each reading costs $0.025 USDC on Base (Coinbase L2). Payment uses the x402 protocol -- an open HTTP payment standard. No API keys. No accounts with PYTHIA. Your wallet signature is your identity.

How x402 payment works

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 request4. PYTHIA verifies payment on-chain, returns the reading5. Total time added: ~2 seconds

This happens automatically if your agent uses an x402-aware client. Your agent does not manually handle crypto.

Setting up x402 in your agent

What you need:

  • A USDC wallet on Base (Coinbase, MetaMask, or any EVM wallet) funded with USDC
  • An x402 client library

Python:

bash
pip install x402[evm] mcp
python
from x402.clients.mcp import x402_mcp_clientfrom mcp.client.streamable_http import streamablehttp_clientfrom 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:

bash
npm install @x402/fetch
typescript
import { withPaymentInterceptor } from "@x402/fetch";// Wraps fetch to automatically handle 402 responses with USDC paymentconst payingFetch = withPaymentInterceptor(fetch, walletClient);

Coinbase AgentKit: x402 support is built in. No additional setup.

See x402.org for all SDKs and framework integrations.

Note: The Python example above uses the x402 SDK's MCP helper. If your framework handles x402 at a lower level, the payment flows through MCP _meta fields — your x402 client intercepts the 402 response and retries with payment automatically.

If you don't have x402 set up

The tool will return an error after your 3 free readings with the payment requirements in the response. Your 3 free readings always work regardless.

Links

License

Proprietary. The oracle's methodology is not open source.

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

來源:README.md,提交 dce27eb

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.3最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。