orisha-data-mcp

orisha-data MCP Server

MCP server for orisha-data, an agent-payable x402 market-data service at https://orisha-data.com.

It exposes free preview tools and paid x402 tools for:

• C1 crypto/FX price samples.
• D1 CME micro futures structural levels.

This package is for agent and MCP-client distribution. It does not run the production orisha-data HTTP server.

Install

npm install -g orisha-data-mcp

Run:

orisha-data-mcp

Or with npx after publication:

npx -y orisha-data-mcp

Configuration

Environment variables:

Variable	Required	Default	Purpose
ORISHA_DATA_BASE_URL	No	https://orisha-data.com	orisha-data API base URL
ORISHA_X402_NETWORK	No	eip155:8453	x402 payment network
ORISHA_MCP_EVM_PRIVATE_KEY	Paid tools only	none	EVM wallet private key for x402 payments
EVM_PRIVATE_KEY	Paid tools only	none	fallback wallet private key

Free preview tools work without a wallet key. Paid tools require ORISHA_MCP_EVM_PRIVATE_KEY or EVM_PRIVATE_KEY.

Tools

Tool	Endpoint	Payment	Description
orisha_c1_preview	/c1/preview/:pair	Free	Sample response for C1 crypto/FX price endpoint
orisha_d1_preview	/d1/preview	Free	D1 freshness and redacted structure preview
orisha_c1_price	/c1/price/:pair	Paid x402, USD $0.01	C1 crypto/FX price call
orisha_d1_levels	/d1/levels	Paid x402, USD $0.07	D1 CME micro futures structural levels call

D1 product coverage window: Monday-Friday 09:30-16:10 America/New_York. Scanner/push cadence targets every 3 minutes during that window. Fresh D1 data is 0-600 seconds old; warning data is 601-1200 seconds old; during market-open periods, D1 data older than 1200 seconds is refused before payment.

Claude Desktop Example

{
  "mcpServers": {
    "orisha-data": {
      "command": "npx",
      "args": ["-y", "orisha-data-mcp"],
      "env": {
        "ORISHA_DATA_BASE_URL": "https://orisha-data.com",
        "ORISHA_X402_NETWORK": "eip155:8453",
        "ORISHA_MCP_EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

For preview-only use, omit the wallet key.

Public Service Metadata

• Docs: https://orisha-data.com/docs
• OpenAPI: https://orisha-data.com/openapi.json
• x402 discovery: https://orisha-data.com/.well-known/x402
• Health: https://orisha-data.com/health

Boundaries

orisha-data is a market-data API. It is not a broker, not a trading bot, and does not place orders.

No API key or user account is required. Paid calls use x402.