Ophis Extension

This tutorial covers how to add Ophis as a goose extension so goose can turn natural-language swap requests into executable orders across supported chains.

Quick Install

goose Desktop

Launch the installer

goose CLI

Use goose configure to add a Remote Extension (Streamable HTTP) extension type with:

Endpoint URL

https://mcp.ophis.fi/mcp

What is Ophis?

Ophis is an intent-based DEX aggregator with a natural-language layer and a keyless MCP server for AI agents. It is non-custodial, gasless, and MEV-protected, and returns swap surplus to the trader. Ophis is a fork of CoW Protocol. It deploys its own settlement contracts on Optimism and Unichain and routes through CoW Protocol on the other supported chains: Ethereum, Base, Arbitrum, Polygon, BNB Chain, Gnosis, Avalanche, Linea, Plasma, and Ink.

The MCP server is keyless and requires no API key or environment variables. It exposes fourteen tools: parse_intent, resolve_token, list_chains, get_quote, expected_surplus, build_order, validate_order, submit_order, lookup_tier, get_integrator_earnings, get_balances, get_portfolio, get_gas, and get_token_chart. Trades are signed by the user's own wallet, so the server never holds keys or funds.

Configuration

goose Desktop

1. Launch the installer
2. Click Yes to confirm the installation
3. Click the button in the top-left to open the sidebar
4. Navigate to the chat

goose CLI

1. Run the configure command:

goose configure

2. Choose to add a Remote Extension (Streamable HTTP).

┌   goose-configure
│
◇  What would you like to configure?
│  Add Extension
│
◆  What type of extension would you like to add?
│  ○ Built-in Extension
│  ○ Command-line Extension
│  ● Remote Extension (Streamable HTTP) (Connect to a remote extension via MCP Streamable HTTP)
└

3. Give your extension a name.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Remote Extension (Streamable HTTP)
│
◆  What would you like to call this extension?
│  Ophis
└

4. Enter the Streamable HTTP endpoint URI.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension 
│
◇  What type of extension would you like to add?
│  Remote Extension (Streamable HTTP)
│
◇  What would you like to call this extension?
│  Ophis
│
◆  What is the Streamable HTTP endpoint URI?
│  https://mcp.ophis.fi/mcp
└

5. Enter the number of seconds goose should wait for actions to complete before timing out. Default is 300 seconds.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Remote Extension (Streamable HTTP)
│
◇  What would you like to call this extension?
│  Ophis
│
◇  What is the Streamable HTTP endpoint URI?
│  https://mcp.ophis.fi/mcp
│
◆  Please set the timeout for this tool (in secs):
│  300
└

6. Enter a description for this extension.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension
│
◇  What type of extension would you like to add?
│  Remote Extension (Streamable HTTP)
│
◇  What would you like to call this extension?
│  Ophis
│
◇  What is the Streamable HTTP endpoint URI?
│  https://mcp.ophis.fi/mcp
│
◇  Please set the timeout for this tool (in secs):
│  300
│
◆  Enter a description for this extension:
│  Natural-language intent DEX aggregator with a keyless MCP server for AI agents
└

7. Choose No when asked to add custom headers.

┌   goose-configure 
│
◇  What would you like to configure?
│  Add Extension 
│
◇  What type of extension would you like to add?
│  Remote Extension (Streamable HTTP)
│
◇  What would you like to call this extension?
│  Ophis
│
◇  What is the Streamable HTTP endpoint URI?
│  https://mcp.ophis.fi/mcp
│
◇  Please set the timeout for this tool (in secs):
│  300
│
◇  Enter a description for this extension:
│  Natural-language intent DEX aggregator with a keyless MCP server for AI agents
│
◆  Would you like to add custom headers?
│  No
│
└  Added Ophis extension

Example Usage

Once Ophis is configured, you can describe a swap in plain language and ask goose to prepare an order. Here are some examples:

Parse an intent

Parse this swap intent: "swap 100 USDC for ETH on Base".

Get a quote

Get a quote to swap 0.5 WETH for USDC on Arbitrum.

List supported chains

Which chains does Ophis support?

The server returns a quote and an unsigned order. The actual trade is signed by your own wallet, so no keys or funds are ever shared with the extension.

Resources

• Website: ophis.fi
• App: swap.ophis.fi
• Docs: docs.ophis.fi
• Agent skills for shell-capable agents: ophis.fi/.well-known/agent-skills
• Source: github.com/ophis-fi/ophis