# Orkid Swap

> Gasless MEV-protected swaps + cross-chain quotes across EVM chains — incl. tokenized stocks.

- name: xyz.orkidlabs/orkid-swap
- version: 1.0.2
- connection class: R0 (autonomous)
- trust: 96/100
- quality: 87/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/xyz.orkidlabs%2Forkid-swap
- tools: https://api.protogrid.dev/v1/servers/xyz.orkidlabs%2Forkid-swap/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "orkid-swap": {
      "type": "http",
      "url": "https://orkidlabs.xyz/api/mcp",
      "headers": {
        "X-ORKID-API-Key": "${X_ORKID_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${X_ORKID_API_KEY}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% +updated-18d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 87/100 (good)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 88 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 23 of 23 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: sv_macro (idempotentHint); orkid_quote (idempotentHint); orkid_swap_link (idempotentHint); …
- pass `tools.token_cost`: about 4,646 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump
- pass `tools.hidden_text`: no hidden text in tool names, descriptions, schemas or annotations

### stability: 83 (weight 15)

- warn `stability.changes`: 27 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name
- pass `stability.new_links`: no tool change named a new site

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 23, about 4,646 tokens to load them all
- tool set hash: 816a8f6b62a278263d4455fb693b657b
- tools last changed: 2026-11-07T10:10:39.989Z
- badge: [![protogrid quality](https://protogrid.dev/badge/xyz.orkidlabs/orkid-swap.svg)](https://protogrid.dev/servers/xyz.orkidlabs/orkid-swap)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-07 `orkid_chains` changed (description)
  - before: List EVM chains where Orkid same-chain token swaps are live, cross-chain bridge coverage, and gasless minimums per chain — Base, Ethereum, Arbitrum, Unichain, BSC, Robinhood, Polygon (bridge-only).
  - after: List EVM chains where Orkid same-chain token swaps are live, cross-chain bridge coverage, and gasless minimums per chain — Base, Ethereum, Arbitrum, Unichain, BSC, Robinhood, Polygon.
- 2026-11-06 `sv_aml_report` added
  - Audit-grade sanctions screening report: the $0.05 verdict expanded into per-layer status + latency, full name-match detail (score, dataset, entity id), address-format detection, and a deterministic per-day reportId for audit dedup. Batch: addresses=<a,b,c> up to 5 at the same flat price. Fail-closed — verdict "unscreened" when the oracle cannot be reached. Informational only — not compliance advice. Free with X-ORKID-API-Key or $0.25 USDC/call via x402.
- 2026-11-06 `sv_aml` added
  - Wallet-address sanctions screening: exact-match verdict from our self-hosted OFAC-SDN oracle plus additive entity-name matching across open sanctions lists. Fail-closed — returns verdict "unscreened" (isSanctioned null) when no layer answered, never a fabricated clean. Params: address (required), entity (optional name hint), chain (optional echo). Informational only — not compliance advice. Free with X-ORKID-API-Key or $0.05 USDC/call via x402.
- 2026-11-06 `sv_uniswapx` changed (description, inputSchema)
  - before: Orkid solver telemetry over public UniswapX orders: observed orders, achievable vs decayed-required output, executable surplus, funnel decisions across Ethereum/Base/Arbitrum/BSC, plus armed-fill landability sims. Panels: uniswapx_evals_{chain}, uniswapx_shadow_{chain}. Params: panel, start/end, limit. Free with X-ORKID-API-Key or $0.02 USDC/call via x402.
  - after: Orkid solver telemetry over public UniswapX orders: observed orders, achievable vs decayed-required output, executable surplus, funnel decisions across Ethereum/Base/Arbitrum/BSC, plus armed-fill landability sims and the daily realizability funnel (claimed surplus-positive rate vs sim-proven landability). Panels: uniswapx_evals_{chain}, uniswapx_shadow_{chain}, uniswapx_realizability. Params: panel, start/end, limit. Free with X-ORKID-API-Key or $0.02 USDC/call via x402.
- 2026-11-06 `sv_facts` added
  - Public-domain standardized fundamentals from SEC XBRL companyfacts: revenues, net income, assets, liabilities, equity, EPS per CIK/ticker (companyfacts panel). Params: ticker, limit. Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- 2026-11-06 `sv_treasury` added
  - US Treasury auction results — public domain (treasury_auctions panel). Params: limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- 2026-11-06 `sv_cot` added
  - Commitment of Traders financial-futures positioning — public-domain weekly commercial/non-commercial net positions (cot_positions panel). Params: limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- 2026-11-06 `sv_index_events` added
  - Index membership add/drop events derived from public holdings + wiki sources (index_events panel). Params: ticker, start/end, limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- 2026-11-06 `sv_factors` added
  - PCA factor loadings per ticker/date — 22-component regime decomposition (state_vector_pca panel). Params: ticker, start/end, limit. Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- 2026-11-06 `sv_uniswapx` added
  - Orkid solver telemetry over public UniswapX orders: observed orders, achievable vs decayed-required output, executable surplus, funnel decisions across Ethereum/Base/Arbitrum/BSC, plus armed-fill landability sims. Panels: uniswapx_evals_{chain}, uniswapx_shadow_{chain}. Params: panel, start/end, limit. Free with X-ORKID-API-Key or $0.02 USDC/call via x402.

Full history: https://api.protogrid.dev/v1/servers/xyz.orkidlabs%2Forkid-swap/changes

## Remotes

- https://orkidlabs.xyz/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (23)

- `orkid_bridge_quote`: Get a non-custodial cross-chain bridge quote (Across) — bridge USDC, WETH, ETH, and tokens between Base, Ethereum, Arbitrum, Polygon, and Robinhood Chain (4663). Use when a user wants to bridge crypto across chains or move funds to Robinhood Chain tokenized equities. Returns unsigned transaction data — the depositor wallet signs and broadcasts. Free with X-ORKID-API-Key header or $0.002 USDC/call via x402.
- `orkid_chains`: List EVM chains where Orkid same-chain token swaps are live, cross-chain bridge coverage, and gasless minimums per chain — Base, Ethereum, Arbitrum, Unichain, BSC, Robinhood, Polygon.
- `orkid_quote`: Get a live, non-executing crypto token swap quote from the Orkid solver network — best route across Tycho + RFQ DEX liquidity, gasless via Permit2 (solver pays gas, no ETH/BNB needed), MEV-protected. Same-chain swaps on Base, Ethereum, Arbitrum, Unichain, BSC, and Robinhood Chain (tokenized stocks, chain 4663). Use when a user wants to swap tokens, trade crypto, or buy tokenized equities. The response includes a swapUrl — send the user there to sign; the agent never touches keys. Free with X-ORKID-API-Key header (key at orkidlabs.xyz/partner) or $0.002 USDC/call via x402.
- `orkid_swap_link`: Build a hydrated Orkid crypto swap URL (prefilled token pair, amount, chain, partner attribution). Use when a user needs a swap link to review — they sign in their own wallet, the agent never touches keys. Requires X-ORKID-API-Key header like all tool calls.
- `sv_aml`: Wallet-address sanctions screening: exact-match verdict from our self-hosted OFAC-SDN oracle plus additive entity-name matching across open sanctions lists. Fail-closed — returns verdict "unscreened" (isSanctioned null) when no layer answered, never a fabricated clean. Params: address (required), entity (optional name hint), chain (optional echo). Informational only — not compliance advice. Free with X-ORKID-API-Key or $0.05 USDC/call via x402.
- `sv_aml_report`: Audit-grade sanctions screening report: the $0.05 verdict expanded into per-layer status + latency, full name-match detail (score, dataset, entity id), address-format detection, and a deterministic per-day reportId for audit dedup. Batch: addresses=<a,b,c> up to 5 at the same flat price. Fail-closed — verdict "unscreened" when the oracle cannot be reached. Informational only — not compliance advice. Free with X-ORKID-API-Key or $0.25 USDC/call via x402.
- `sv_cot`: Commitment of Traders financial-futures positioning — public-domain weekly commercial/non-commercial net positions (cot_positions panel). Params: limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- `sv_factors`: PCA factor loadings per ticker/date — 22-component regime decomposition (state_vector_pca panel). Params: ticker, start/end, limit. Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- `sv_facts`: Public-domain standardized fundamentals from SEC XBRL companyfacts: revenues, net income, assets, liabilities, equity, EPS per CIK/ticker (companyfacts panel). Params: ticker, limit. Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- `sv_filings`: Public-domain EDGAR filing metadata: filings_10k, filings_10q, filing_acceptance, report_calendar_us, sector_history — accession numbers, CIK, filing dates, document URLs, filing calendar, SIC sector classifications. Params: panel, ticker, start/end, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- `sv_filing_sentiment`: Loughran-McDonald sentiment scored on public-domain EDGAR 10-K/10-Q narrative text: filing_sentiment panel — accession, CIK, ticker, filing date, sentiment_local (-1..+1), lm_pos/lm_neg counts. Params: ticker, start/end, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- `sv_fsds`: Download an SEC Financial Statement Data Set quarterly archive (parsed XBRL company fundamentals — statements, segments, tags for every SEC filer). Public-domain data; pass q="list" for the free coverage index (2009q1→present) or q=YYYYq[1-4] for a quarterly zip. Free with X-ORKID-API-Key or $0.005 USDC/call via x402. Files over 4MB return the HTTP download URL instead of an inline blob.
- `sv_fsds_bulk`: Complete SEC Financial Statement Data Set archive — 70 quarterly XBRL datasets (2009q1–2026q2, ~5.3GB, public domain). Returns a presigned R2 download URL valid for 1 hour; the file streams directly from object storage. Free with X-ORKID-API-Key or $499 USDC/call via x402.
- `sv_futures`: Futures state-vector rows — ~130 derived columns per contract-day: forward-return labels (y_cc/y_settle/y_oc), roll-boundary flags, session mechanics, Kyle lambda variants, ADV share, macro/yield context. Live futures feed. OHLCV/settlement prices stripped — labels and derived features only. Params: ticker (required), start/end, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.05 USDC/call via x402.
- `sv_futures_ref`: Futures contract reference + mechanics: futures_products, futures_meta, futures_contracts, futures_schedules, futures_roll, futures_anchor_map, futures_sessions, futures_anchors, prop_constraints, apex_constraints. Price/volume columns stripped — specs and mechanics only. Params: panel, ticker, start/end, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- `sv_index_events`: Index membership add/drop events derived from public holdings + wiki sources (index_events panel). Params: ticker, start/end, limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- `sv_macro`: Federal public-domain macro panels: macro_treasury_yields, macro_funding_conditions, macro_inflation, macro_inflation_expectations, macro_labor_market, market_holidays. Params: panel, start/end YYYY-MM-DD, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- `sv_manifest`: Free dataset index for the Orkid StateVector API — panel census, coverage windows, and freshness for every served dataset (state vectors, PCA panels, microstructure, SEC FSDS fundamentals, futures, crypto). Use first to discover what is available and how current it is before paying for data.
- `sv_micro`: Derived tick-level microstructure per ticker-day/session: Kyle lambda variants, Amihud illiquidity, realized vol, depth/imbalance, signed flow. vwap/dollar-volume price fields stripped. Panels: microstructure_daily, futures_micro. Params: panel, ticker, start/end, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.01 USDC/call via x402.
- `sv_similar`: Find the historical market states most similar to a ticker on a given date — k nearest neighbors in the 22-dimensional regime vector space across ~3M ticker-days (2014→present). Returns {ticker, date, similarity} triples. The query nobody else sells. Params: ticker (required), at YYYY-MM-DD (default: latest), k (default 15, max 200). Free with X-ORKID-API-Key or $0.02 USDC/call via x402.
- `sv_treasury`: US Treasury auction results — public domain (treasury_auctions panel). Params: limit. Free with X-ORKID-API-Key or $0.005 USDC/call via x402.
- `sv_uniswapx`: Orkid solver telemetry over public UniswapX orders: observed orders, achievable vs decayed-required output, executable surplus, funnel decisions across Ethereum/Base/Arbitrum/BSC, plus armed-fill landability sims and the daily realizability funnel (claimed surplus-positive rate vs sim-proven landability). Panels: uniswapx_evals_{chain}, uniswapx_shadow_{chain}, uniswapx_realizability. Params: panel, start/end, limit. Free with X-ORKID-API-Key or $0.02 USDC/call via x402.
- `sv_vectors`: Daily abstract state vectors for a US equity ticker — 37 derived features per trading day (microstructure: Kyle lambda, Amihud illiquidity, realized diffusion; valuation gaps; surprise bits; options-surface stats; 7 quality flags). Point-in-time safe, 2014→present. Price columns stripped — derived features only. Params: ticker (required), start/end YYYY-MM-DD, limit (default 100, max 500). Free with X-ORKID-API-Key or $0.01 USDC/call via x402.