MCP 服务器

agentoracle-mcp

MCP server that connects AI assistants (Claude, Cursor, Windsurf) to AgentOracle's real-time research API. Agents can research any topic and get structured JSON with summary, key facts, sources, and confidence scores. Powered by Perplexity Sonar via x402 protocol on Base

README

AgentOracle MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Claude, Cursor, and Windsurf to AgentOracle — a pay-per-query real-time research API for AI agents.

What It Does

This MCP server exposes AgentOracle's research capabilities as tools that any MCP-compatible AI assistant can call:

Tool	Description	Cost
`research`	Real-time research on any topic — returns structured JSON with summary, key facts, sources, and confidence score	$0.02 USDC
`deep-research`	Comprehensive deep analysis with expert-level findings, 10-15 detailed facts, and analysis paragraph	$0.10 USDC
`check-health`	Check if AgentOracle API is online with service status	Free
`get-manifest`	Get x402 payment manifest with pricing and endpoint details	Free

Payments are handled via the x402 protocol on Base mainnet using USDC.

Quick Start

Install from npm

npm install -g agentoracle-mcp

Or clone and build from source

git clone https://github.com/TKCollective/agentoracle-mcp.git
cd agentoracle-mcp
npm install
npm run build

Usage with Claude Desktop

Add this to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "agentoracle": {
      "command": "npx",
      "args": ["-y", "agentoracle-mcp"]
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "agentoracle": {
      "command": "agentoracle-mcp"
    }
  }
}

Usage with Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "agentoracle": {
      "command": "npx",
      "args": ["-y", "agentoracle-mcp"]
    }
  }
}

Example

Once connected, you can ask your AI assistant things like:

"Use AgentOracle to research the latest DeFi protocol TVL rankings on Base"

The assistant will call the research tool and return structured results:

{
  "query": "Latest DeFi protocol TVL rankings on Base",
  "tier": "standard",
  "result": {
    "summary": "As of March 2026, Base L2 DeFi TVL has reached...",
    "key_facts": [
      "Aerodrome leads Base DeFi with $3.2B TVL",
      "Aave v3 on Base holds $1.8B"
    ],
    "sources": ["https://defillama.com/..."],
    "confidence_score": 0.89
  },
  "confidence": {
    "score": 0.89,
    "level": "high",
    "sources_count": 6,
    "facts_count": 5
  },
  "freshness": "recent",
  "metadata": {
    "model": "sonar",
    "api_version": "1.3.0",
    "response_time_ms": 2100
  }
}

How Payment Works

AgentOracle uses the x402 protocol for payments:

The MCP tool sends your query to AgentOracle
If no payment header is present, the API returns HTTP 402 with payment requirements
Use an x402-compatible client to sign a USDC payment on Base
Resubmit the request with the payment header to get full results

The free check-health and get-manifest tools work without any payment.