# Spydra — how to use (mcp.ai)

Connect your Spydra account and use 10 tools for commerce straight from your AI agent. Connect with your own API key. Spydra OpenRWA provides public-chain token store APIs for assets, tokens, sales, investments, investor workflows, payouts, and chain configuration.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_spydra?ms=1787296020000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `spydra_get_asset`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/spydra`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/spydra/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/spydra/get/asset` — Return detailed information for one OpenRWA asset, optionally including token or token-sale projections.
  - body: { asset_id: string, projection?: string[] }
- `POST https://api.mcp.ai/api/spydra/get/asset/status/counts` — Return asset counts grouped by publication status for the connected OpenRWA token store.
- `POST https://api.mcp.ai/api/spydra/list/asset/tokens` — Return the tokens associated with one OpenRWA asset.
  - body: { asset_id: string }
- `POST https://api.mcp.ai/api/spydra/list/assets` — Return one numbered page of draft or published assets in the connected OpenRWA token store.
  - body: { page?: integer, limit?: integer, status: integer }
- `POST https://api.mcp.ai/api/spydra/list/chains` — Return supported OpenRWA blockchain networks and their public network, currency, status, and fee attributes. test_mode=true is verified to return testnets; the provider currently does not reliably tre
  - body: { test_mode?: boolean }
- `POST https://api.mcp.ai/api/spydra/list/countries` — Return the complete OpenRWA country reference list, including ISO codes, currencies, languages, and dialing codes.
- `POST https://api.mcp.ai/api/spydra/list/investor/tokens` — Return one numbered page of tokens held or invested in by a specific OpenRWA investor.
  - body: { page?: integer, limit?: integer, test_mode?: boolean, investor_id: string }
- `POST https://api.mcp.ai/api/spydra/list/investor/transactions` — Return one numbered page of mint, payout, burn, or token-creation transactions for a specific OpenRWA investor.
  - body: { page?: integer, limit?: integer, test_mode?: boolean, investor_id: string, transaction_types?: string[], transaction_statuses?: integer[] }
- `POST https://api.mcp.ai/api/spydra/list/investors` — Return one numbered page of investors registered with the connected OpenRWA token store.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/spydra/list/token/sales` — Search and filter one numbered page of OpenRWA token sales available through the connected store.
  - body: { page?: integer, sort?: string, term?: string, limit?: integer, test_mode?: boolean, sale_status?: integer, investment_type?: integer }

## Example prompts
- "What can I do in Spydra?"
- "Show me a summary of my Spydra account"

## More
- Page: https://mcp.ai/spydra
- Agent spec (llms.txt): https://mcp.ai/spydra/llms.txt
- Postman collection: https://mcp.ai/spydra/postman.json