MCP Guide

Norynta MCP tools support market discovery, analysis, and virtual-credit play. They do not expose real-money order placement, funding, or payout tools.

Server map

Server	Use	Main tools
Hosted remote MCP	Hosted assistants and agents	agent_bootstrap, discovery tools, paper_trade, paper_positions, paper_close
norynta-public	Local discovery and analysis	agent_bootstrap, market_search, events_top, events_snapshots, validate_trade, estimate_impact
norynta-play	Local virtual-credit writes	play_order_open, play_positions, play_order_close
norynta-ops	Read-only local diagnostics	ops_get_env_status, ops_get_mcp_status

The old norynta-trading profile and npm run mcp-trading command remain compatibility aliases for norynta-play. They do not restore live trading.

Hosted quickstart

Use:

https://mcp.norynta.com/mcp

Example OpenAI Responses API configuration:

{
  "type": "mcp",
  "server_label": "norynta",
  "server_url": "https://mcp.norynta.com/mcp",
  "require_approval": "always"
}

After reviewing tool annotations, a host may allow read-only discovery calls without approval. Virtual-credit writes should remain visible to the operator because they change the user's experiment state, even though they never move money.

Local quickstart

npm run mcp-public
npm run mcp-play
npm run mcp-ops
npm run mcp:smoke

The checked-in .mcp.json includes local and production-pinned profiles:

• norynta-public and norynta-public-production;
• norynta-play and norynta-play-production;
• norynta-ops and norynta-ops-production.

Production-pinned means the API target is https://norynta.com; it does not mean real-money execution.

Recommended agent flow

1. Call agent_bootstrap once.
2. Use market_search when you have a query, or events_top for broad discovery.
3. Batch known slugs into one events_snapshots call.
4. Call validate_trade and estimate_impact.
5. Use paper_trade remotely or play_order_open locally.
6. Reconcile with paper_positions or play_positions.
7. Close with paper_close or play_order_close when the experiment calls for it.

Authentication and safety

• Set NORYNTA_AGENT_API_KEY or the legacy NORYNTA_API_KEY.
• The key must be linked to a developer account and include simulations:run.
• Use deterministic idempotency keys for play writes.
• Never provide wallet keys, signatures, seed phrases, or funding credentials.
• A REAL_MONEY_POSTPONED response is terminal; do not retry or try to bypass it.
• Reconcile stream gaps with a fresh snapshot.

Related docs

• docs/public/PLAY_MODE_GUIDE.md
• docs/AGENT_INTEGRATION.md
• docs/public/SDK_AND_EXAMPLES.md
• .mcp.json