Agentoracle

What is Agentoracle?

Agentoracle is an MCP (Model Context Protocol) server that connects AI assistants like Claude, Cursor, and Windsurf to a pay-per-query real-time research API. It exposes AgentOracle's research capabilities as tools that any MCP-compatible AI assistant can call, with payments handled via the x402 protocol on Base mainnet using USDC.

How to use Agentoracle?

Install globally via npm (npm install -g agentoracle-mcp) or clone and build from source. Add the server configuration to your MCP client's config file (e.g., Claude Desktop or Cursor) using either the npx command or the globally installed binary.

Key features of Agentoracle

• Real-time research via the research tool ($0.02 USDC per query)
• Deep research via the deep-research tool ($0.10 USDC per query)
• Free health check and manifest lookup tools
• Powered by Perplexity Sonar for structured JSON results
• x402 protocol payments on Base mainnet with USDC

Use cases of Agentoracle

• Ask an AI assistant for up-to-date DeFi protocol TVL rankings on Base
• Get structured research results with summary, key facts, and sources
• Perform comprehensive deep analysis with expert-level findings
• Check AgentOracle API availability before submitting paid queries

FAQ from Agentoracle

What tools does Agentoracle provide?

Four tools: research (real-time research, $0.02 USDC), deep-research (deep analysis, $0.10 USDC), check-health (free service status), and get-manifest (free payment pricing details).

How does payment work?

Agentoracle uses the x402 protocol. If no payment header is present, the API returns HTTP 402 with payment requirements. You use an x402-compatible client to sign a USDC payment on Base, then resubmit the request. Free tools work without payment.

What dependencies or runtime does it require?

Node.js and npm. The server is built with the Model Context Protocol SDK, AgentOracle API (powered by Perplexity Sonar), x402 protocol by Coinbase, and Zod for input validation.

Where does research data come from?

The AgentOracle API performs real-time research powered by Perplexity Sonar, returning structured JSON with summary, key facts, sources, and a confidence score.

What transports or authentication does it support?

The server uses standard MCP transport. Payments are authenticated via the x402 protocol using USDC on Base mainnet; no other authentication is mentioned.