agentoracle-mcp
The agentoracle-mcp server connects AI assistants to AgentOracle's pay-per-query research API, using the x402 protocol for USDC payments on Base mainnet.
Real-time Research (
research): Ask any natural language question and receive structured JSON with a summary, key facts, cited sources, and a confidence score — costs $0.02 USDC per query.Deep Research (
deep-research): Perform comprehensive, expert-level analysis on complex topics, returning 10–15 detailed facts, an in-depth analysis paragraph, cited sources, and a confidence score — costs $0.10 USDC per query.Health Check (
check-health): Verify the AgentOracle API is online and retrieve service status (uptime, model info, pricing) — free.Payment Manifest (
get-manifest): Retrieve the x402 payment manifest with payment requirements, supported networks, pricing, and endpoint details for programmatic integration — free.AI Assistant Integration: Compatible with MCP-enabled assistants such as Claude Desktop, Cursor, and Windsurf.
Facilitates USDC payments on Base mainnet using the x402 protocol, allowing automated payment handling for per-query research costs ($0.02-$0.10 USDC).
Leverages Perplexity Sonar models to power real-time research queries, providing structured research results, expert-level analysis, and cited sources through the AgentOracle API.
AgentOracle MCP Server
MCP server that connects AI assistants (Claude, Cursor, Windsurf, etc.) to AgentOracle — a pay-per-query research API for AI agents via the x402 protocol.
Tools
Tool | Description | Cost |
| Real-time web research on any topic. Returns summary, key facts, sources, confidence score. | $0.02 USDC |
| Comprehensive expert-level analysis. Returns detailed findings with in-depth analysis. | $0.10 USDC |
| Check if AgentOracle API is online and get service status. | Free |
| Get the x402 payment manifest for programmatic integration. | Free |
Resources
Resource | Description |
| Full API documentation with endpoints, pricing, and integration guide |
Install via Smithery
npx @smithery/cli install agentoracle-mcpInstall Manually
Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"agentoracle": {
"command": "npx",
"args": ["agentoracle-mcp"]
}
}
}Cursor
Add to your Cursor MCP settings:
{
"mcpServers": {
"agentoracle": {
"command": "npx",
"args": ["agentoracle-mcp"]
}
}
}How It Works
Your AI assistant calls the
researchordeep-researchtool with a questionThe MCP server sends the query to AgentOracle's API
AgentOracle returns structured JSON with real-time research results
Payment is handled via the x402 protocol — $0.02 or $0.10 USDC on Base mainnet
Response Format
Standard Research
{
"query": "What are the latest AI agent frameworks?",
"result": {
"summary": "Concise summary of findings",
"key_facts": ["Fact 1", "Fact 2", "Fact 3"],
"sources": ["https://source1.com", "https://source2.com"],
"confidence_score": 0.92
}
}Deep Research
{
"query": "Comprehensive analysis of x402 protocol adoption",
"tier": "deep",
"result": {
"summary": "Detailed 2-3 paragraph summary",
"key_facts": ["10-15 detailed facts..."],
"analysis": "Expert analysis paragraph",
"sources": ["https://source1.com"],
"confidence_score": 0.95
}
}Links
x402 Manifest: https://agentoracle.co/.well-known/x402.json
Health Check: https://agentoracle.co/health
Twitter: @AgentOracle_AI
License
MIT
Appeared in Searches
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/TKCollective/agentoracle-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server