[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_116":117},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@ophis-fi/ophis' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","ophis-fi","moduleId","ophis","@ophis-fi/ophis","displayName","Ophis MCP","tagline","Agent tools for the Ophis intent-based DEX: parse, quote, build, relay orders, look up fee tiers.","iconKey","https://avatars.githubusercontent.com/u/283687920?v=4","category","ai-agents","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://mcp.ophis.fi/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363298000,"updatedAt",1781499442000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=fi.ophis%2Fmcp","sourceVerified",false,"importedAt","upstreamStars",2,"upstreamUpdatedAt",1781478283000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/ophis-fi/ophis","githubRepoFullName","ophis-fi/ophis","releaseId","ext-ophis-fi-ophis","version","0.0.1","descriptionMarkdown","

\n $\"Ophis\"$ \n

\n\n

Ophis

\n\n

\n Describe a trade in plain English. Ophis does the rest.
\n An intent-based DEX aggregator with a natural-language layer, built for humans and agents alike.\n

\n\n

\n $\"CI\"/$ \n $\"CodeQL\"/$ \n $\"Security$ \n $\"GPL-3.0$ \n $\"OP$ \n

\n\n

\n Swap App ·\n Docs ·\n Explorer ·\n Agents ·\n SDK ·\n Security\n

\n\n---\n\nSay `swap 100 USDC for ETH on Base` and Ophis resolves the tokens, chain, and\namount, then fills the order through a competitive solver auction that settles\non-chain. It is a fork of [CoW Protocol](https://cow.fi) (orderbook, autopilot,\ndriver, and baseline solver) with a natural-language intent layer over a\nrebranded CoW Swap UI. On Optimism, Ophis runs the whole stack under its own\nsettlement contracts and keeps the full fee; on the other supported chains\n(Ethereum, Base, Arbitrum, and more) it routes through CoW Protocol's hosted\nnetwork.\n\nWhat that buys you on every trade:\n\n- **Gasless, MEV-protected.** Orders settle in a batch auction where every trade\n clears at one uniform price, so sandwiches and front-running are structurally\n absent, not best-effort.\n- **Surplus stays with you.** Solvers compete to beat the price you signed, and\n any improvement is returned to you in full. Ophis takes a flat fee on volume\n and zero share of your surplus.\n- **Non-custodial, no account, no auth.** Every order is signed in your own\n wallet (EIP-712 or ERC-1271). Ophis never holds keys or funds and cannot move,\n freeze, or recover them. The signature is the only trust boundary.\n- **A flat, transparent fee.** 0.10% (10 bps) on volume, dropping to 0.01%\n (1 bp) on same-chain stablecoin pairs, with a share returned monthly as WETH\n rebates plus an 8% referral on trades you bring.\n\n**Live across the CoW-supported chains**, with its own self-hosted settlement and\nsolver on Optimism (chain 10).\n\n## Quickstart: the Intent API\n\nOphis's one bespoke API turns natural language into a structured order. No key,\nno account, just POST your request:\n\n```bash\ncurl -sS https://ophis.fi/api/intent \\\n -H 'content-type: application/json' \\\n -d '{\"text\":\"swap 100 USDC for ETH on Base\"}'\n```\n\n```json\n{\n \"ok\": true,\n \"data\": {\n \"intent\": \"swap\",\n \"entities\": [\n { \"type\": \"amount\", \"value\": \"100\", \"raw\": \"100\", \"start\": 5, \"end\": 8 },\n { \"type\": \"sellToken\", \"value\": \"USDC\", \"raw\": \"USDC\", \"start\": 9, \"end\": 13 },\n { \"type\": \"buyToken\", \"value\": \"ETH\", \"raw\": \"ETH\", \"start\": 18, \"end\": 21 },\n { \"type\": \"chain\", \"value\": \"base\", \"raw\": \"Base\", \"start\": 25, \"end\": 29 }\n ]\n }\n}\n```\n\nMap the chain slug to a chain ID and hand the user a swap deep link to review and\nsign. The endpoint only normalizes text, it never places, signs, or executes a\ntrade. It is rate-limited to 30 requests per minute per IP; non-browser callers\n(no `Origin` header) are allowed, which is the path agents use. Full reference:\n[docs.ophis.fi/intent-api](https://docs.ophis.fi/intent-api).\n\n## Agents and SDK\n\nOphis is built to be traded by autonomous agents, not just people. Pick your\nintegration depth, all of it non-custodial and keyless:\n\n### MCP server (recommended)\n\nPoint any MCP client (Claude, Cursor, a custom agent) at the hosted Model\nContext Protocol server:\n\n```\nhttps://mcp.ophis.fi/mcp\n```\n\nIt speaks Streamable-HTTP MCP and exposes six tools: `parse_intent`,\n`get_quote`, `build_order`, `submit_order`, `lookup_tier`, and `list_chains`.\nThe server holds no keys and never signs. `build_order` returns a bounded,\nready-to-sign EIP-712 order with the receiver pinned to the owner; the agent\nsigns locally with its own key and submits. (A bare request without an\n`Accept: text/event-stream` header returns HTTP 406, that is the transport\nnegotiating, not an outage.)\n\n### @ophis/sdk\n\nFor agents that build and sign CoW orders directly:\n\n```bash\nnpm install @ophis/sdk\n```\n\nThe SDK encodes four fork details that fail **silently** if you guess them:\n\n- **`getOphisOrderbookUrl(chainId)`** picks the right host. Optimism self-hosts\n its orderbook (not `api.cow.fi`); the wrong host bypasses the Ophis solver and\n zeroes the fee.\n- **`getOphisOrderDomain(chainId)`** gives the EIP-712 domain with the correct\n `verifyingContract`. The OP settlement is non-canonical, so the cow-sdk default\n is rejected on-chain.\n- **`buildOphisAppDataPartnerFee(chainId)`** builds the exact CIP-75 volume-fee\n fragment `{ volumeBps, recipient }`, not the price-improvement shape.\n- **`assertReceiverIsOwner(owner, receiver)`** pins the order receiver. An\n unpinned receiver is the number one drain vector for an automated signer.\n\n### Discovery and the trust boundary\n\nOphis publishes machine-readable manifests for agent discovery under\n`https://ophis.fi/.well-known/`: `mcp.json`, `ai-plugin.json`, `agent-skills/`,\nand `api-catalog` (RFC 9727), plus the root-served `auth.md`, `llms.txt`, and\n`openapi.json`.\n\nThese off-chain helpers make the safe path the easy path, but they are guards,\nnot an authorization boundary: a prompt-injected agent can ignore them. For an\nagent that signs **without a human in the loop**, enforce policy where the agent\ncannot reach it: funds in a Safe smart account, a deterministic policy gate\n(allowlisted tokens, pinned receiver and appData, an oracle-bounded limit price,\nspend caps), a guardian key, and the same policy checked again at orderbook\ningestion. Full guide: [docs.ophis.fi/ai-agents](https://docs.ophis.fi/ai-agents).\n\n## Status\n\nOphis settles across two kinds of chains.\n\n**Ophis-operated** (self-hosted orderbook, solver, and settlement; Ophis keeps the\nfull fee):\n\n| Chain | Chain ID | Status |\n|---|---|---|\n| Optimism | 10 | **Live**: settlement, solver, partner fee |\n| HyperEVM | 999 | Contracts deployed, stack paused |\n| MegaETH | 4326 | Contracts deployed, stack paused |\n\n**CoW-hosted** (orders route through CoW Protocol's settlement and solver network,\nwith the partner fee disbursed by CoW): Ethereum, Base, Arbitrum, Polygon, BNB,\nGnosis, Avalanche, Linea, and the other CoW-supported chains, all live.\n\nThe two have different settlement contracts and orderbook hosts, so resolve them\nper chain via `@ophis/sdk` or the MCP `list_chains` tool rather than assuming.\nFull live status: [docs.ophis.fi/status](https://docs.ophis.fi/status).\nCross-chain destinations (Solana, Bitcoin) are surfaced via NEAR Intents.\nCanonical contract addresses and the disclosure policy live in\n[`SECURITY.md`](https://github.com/ophis-fi/ophis/blob/main/SECURITY.md).\n\n## Architecture\n\n| Path | Origin | Purpose |\n|---|---|---|\n| `apps/frontend/` | [`cowprotocol/cowswap`](https://github.com/cowprotocol/cowswap) (subtree) | Vite/Nx monorepo holding several surfaces: `apps/cowswap-frontend` is the swap UI (Ophis code under `src/ophis/` and `src/modules/mevReceipt/`), `apps/explorer` is the order explorer, `apps/ophis-landing` is the ophis.fi landing site. Self-contained pnpm workspace (own lockfile, excluded from the root). |\n| `apps/backend/` | [`cowprotocol/services`](https://github.com/cowprotocol/services) (subtree) | Rust orderbook, autopilot, driver, baseline solver. Ophis additions live in dedicated crates and `ophis::` module paths. |\n| `apps/mcp-server/` | New | `@ophis/mcp-server`: agent-facing MCP server (Streamable-HTTP) deployed as a Cloudflare Worker at `mcp.ophis.fi/mcp`. Holds no keys and never signs. |\n| `apps/rebate-indexer/` | New | `@ophis/rebate-indexer`: off-chain volume-tier and WETH rebate indexer plus Safe batch proposer ([rebates.ophis.fi](https://rebates.ophis.fi)). |\n| `apps/docs-ophis/` | New | Docusaurus docs portal ([docs.ophis.fi](https://docs.ophis.fi)). Self-contained app (own lockfile, excluded from the root, like `apps/frontend`). |\n| `packages/sdk/` | New | [`@ophis/sdk`](https://github.com/ophis-fi/ophis/blob/main/packages/sdk): dependency-free helpers for the per-chain orderbook host, EIP-712 order domain, CIP-75 partner-fee `appData`, receiver-pinning guards, tier assignment, and the supported-chain registry. |\n| `contracts/` | [`cowprotocol/contracts`](https://github.com/cowprotocol/contracts) (subtree) | `GPv2Settlement`, `GPv2VaultRelayer`, `GPv2AllowListAuthentication`, deployed under an Ophis-controlled solver allowlist. Per-network artifacts in `contracts/deployments/`. |\n| `functions/` | New | Cloudflare Pages Functions: `api/intent.ts` (the natural-language parser, shared by swap and landing), `api/bungee` (bridge proxy), `_middleware.ts` (host routing). |\n| `infra/` | New | Per-chain runtime stacks (`optimism-mainnet/`, `hyperevm-mainnet/`, `megaeth-mainnet/`, `local/`), plus `rpc/` (eRPC) and `cloudflare/` config. |\n\nUpstream subtrees are vendored as-is; Ophis changes are catalogued in\n`apps/frontend/.ophis-divergences.md` and `apps/backend/.ophis-divergences.md`\nso `git subtree pull` stays tractable.\n\n## Repo map\n\n```\nophis/\n├── apps/\n│ ├── frontend/ cowswap fork: swap UI + explorer + landing site\n│ ├── backend/ cowprotocol/services fork (Rust)\n│ ├── rebate-indexer/ tier + WETH rebate API, Safe batch proposer\n│ ├── docs-ophis/ Docusaurus docs portal\n│ └── mcp-server/ agent-facing MCP Worker (mcp.ophis.fi)\n├── contracts/ GPv2 settlement contracts (+ per-network deployments)\n├── packages/sdk/ @ophis/sdk\n├── functions/ Cloudflare Pages Functions (intent API, bungee, middleware)\n├── infra/ per-chain runtime stacks + rpc + cloudflare config\n├── scripts/ repo utility scripts\n└── docs/ specs, plans, audits, operations runbooks\n```\n\n## Build\n\nRoot workspace (pnpm 9, Node 20.19+ or 22.12+, turborepo):\n\n```sh\npnpm install # all root-workspace deps\npnpm build # builds members with a build step (currently @ophis/sdk)\npnpm typecheck # typechecks every member\npnpm test # runs the unit suites\n```\n\nOnly `packages/sdk` has a build step today. `apps/rebate-indexer`,\n`apps/mcp-server`, and `infra/rpc` run directly (no `build` script) and are\nvalidated by `pnpm typecheck` and `pnpm test`. The Rust backend (`apps/backend`)\nis a **Cargo** workspace, not a pnpm package, so build and test it with Cargo:\n\n```sh\ncd apps/backend && cargo build && cargo test\n```\n\n`apps/frontend` and `apps/docs-ophis` are self-contained pnpm workspaces with\ntheir own lockfiles, deliberately excluded from the root. Build them from inside\ntheir own directory (see each app's README):\n\n```sh\ncd apps/frontend && pnpm install --frozen-lockfile && pnpm run build:cowswap\ncd apps/docs-ophis && pnpm install --frozen-lockfile && pnpm run build\n```\n\nThe contracts use Foundry (`forge build`); `forge-std` is a git submodule, so run\n`git submodule update --init` first.\n\n## Deploy\n\nEvery surface deploys independently from `main`:\n\n- **Swap app and Explorer** [`cloudflare-deploy.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/cloudflare-deploy.yml): two sequential Cloudflare Pages deploys (swap.ophis.fi / ophis.fi, then explorer.ophis.fi).\n- **Landing** [`landing-deploy.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/landing-deploy.yml): path-filtered build with a Playwright and Lighthouse budget gate, to Cloudflare Pages.\n- **Docs** [`docs-deploy.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/docs-deploy.yml): the Docusaurus site to its own Cloudflare Pages project.\n- **MCP server** [`mcp-deploy.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/mcp-deploy.yml): to Cloudflare Workers (custom domain `mcp.ophis.fi`) with a least-privilege Workers token.\n- **Rebate indexer** [`rebate-indexer-deploy.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/rebate-indexer-deploy.yml): to self-hosted infrastructure over a private network.\n- **OP backend**: the live Optimism orderbook, autopilot, driver, and solvers run on self-hosted infrastructure via `docker compose` (defined under `infra/optimism-mainnet/`), exposed through a Cloudflare tunnel. Not a GitHub workflow.\n\nQuality gates: [`ci.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/ci.yml) (lint, typecheck, tests),\n[`codeql.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/codeql.yml),\n[`security.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/security.yml) (dependency and supply-chain\nscans), and [`echidna.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/echidna.yml) (contract fuzzing).\n[`sdk-release.yml`](https://github.com/ophis-fi/ophis/blob/main/.github/workflows/sdk-release.yml) publishes `@ophis/sdk` to npm.\n\n## Fees and rebates\n\nOphis charges the CoW Protocol CIP-75 volume policy: a flat **0.10% (10 bps)** of\ntrade volume, reduced to **0.01% (1 bp)** on same-chain stablecoin pairs, and\nnothing on surplus. On Optimism the stack settles on its own infrastructure and\nkeeps the full fee; on CoW-hosted chains the partner share is disbursed weekly in\nWETH.\n\nPart of the fee flows back to traders:\n\n- **Volume-tier rebates.** Each month a share of collected WETH fees is paid back,\n split across active wallets by 30-day volume and tier (Bronze through Platinum).\n The [rebate indexer](https://rebates.ophis.fi) computes shares and a Safe batch\n proposer pays out.\n- **Referrals.** Mint a code, share `https://swap.ophis.fi/?ref=YOURCODE`, and earn\n 8% of the net fee Ophis keeps on trades your referrals route, paid monthly in WETH.\n\nFull numbers and the tier ladder: [docs.ophis.fi/fees](https://docs.ophis.fi/fees)\nand [docs.ophis.fi/affiliate](https://docs.ophis.fi/affiliate).\n\n## Security\n\nSee [`SECURITY.md`](https://github.com/ophis-fi/ophis/blob/main/SECURITY.md) for the disclosure policy, canonical contract\naddresses, the partner-fee recipient and governance model, in-scope components,\nand audit history.\n\n## License\n\n[GPL-3.0](https://github.com/ophis-fi/ophis/blob/main/LICENSE), inherited from upstream CoW Protocol.\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","AI Agents","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106,107,108,109,110,111,112,113,114,115],"license","GPL-3.0","language","Rust","registryName","fi.ophis/mcp","homepage","https://ophis.fi","agent-trading","defi","dex","dex-aggregator","ethereum","intent-based-trading","mev-protection","optimism","rust","solidity","typescript","ENV",{"_118":119,"_120":121,"_122":123},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]