# orisha-data MCP Skill

Use this skill when an agent needs to discover or call orisha-data through MCP.

## Service

Base URL: `https://orisha-data.com`

orisha-data provides x402 paid market-data endpoints for machine buyers.

## Tools

- `orisha_c1_preview`: free C1 preview at `/c1/preview/:pair`.
- `orisha_d1_preview`: free D1 preview at `/d1/preview` with freshness metadata and redacted structure.
- `orisha_c1_price`: paid C1 crypto/FX price call at `/c1/price/:pair`, USD $0.01.
- `orisha_d1_levels`: paid D1 CME micro futures structural levels call at `/d1/levels`, USD $0.07.

## Coverage

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.

## Payment

Paid tools require an EVM wallet private key in the MCP process environment:

```bash
ORISHA_MCP_EVM_PRIVATE_KEY=0x...
```

Fallback:

```bash
EVM_PRIVATE_KEY=0x...
```

Default network: `eip155:8453` Base mainnet.

## Agent Guidance

1. Use preview tools first to confirm service shape and freshness.
2. Use paid tools only when the buyer explicitly wants x402-paid data.
3. Do not treat returned market data as trade execution advice.
4. Do not assume stale D1 data is sold; the service is designed to refuse stale D1 data before payment under its live freshness policy.
5. Do not expose wallet private keys in logs, messages, or transcripts.

## Direct 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`