Zyfai DeFi MCP Server

Use Zyfai from Claude, Grok and Grok Bot, Cursor, Claude Code, compatible custom agents, and a limited ChatGPT preview.

This public Model Context Protocol server exposes Zyfai's yield discovery and personalized DeFi agent through natural-language tools. Discover opportunities, compare strategies, inspect positions, review earnings, and prepare supported account actions without building a separate integration.

Hosted MCP endpoint: https://mcp.zyf.ai/mcp

You do not need to clone or run this repository to use the hosted server.

What you can do

• Discover conservative and balanced yield opportunities
• Compare APY, TVL, protocol, pool, chain, asset, and available risk information
• Inspect an authenticated user's Zyfai portfolio and active positions
• Review earnings, transaction history, and rebalancing information
• Prepare supported deposits and account actions when enabled
• Integrate Zyfai into any compatible Streamable HTTP MCP client

The server is built on @zyfai/sdk and uses remote Streamable HTTP transport.

Connect a client

For current screenshots, authentication behaviour, mobile/desktop availability, and troubleshooting, see Use Zyfai with AI.

Cursor

To test the Agent Plugin before a marketplace listing, copy the two root manifests from a checkout of this repository:

mkdir -p ~/.cursor/plugins/local/zyfai
cp plugin.json mcp.json ~/.cursor/plugins/local/zyfai/

Reload Cursor, find Zyfai in Customize, and complete Zyfai sign-in when prompted. Then follow the read-only smoke test. See Cursor's local plugin instructions.

For a manual Cursor MCP connection, use:

{
  "mcpServers": {
    "zyfai": {
      "url": "https://mcp.zyf.ai/mcp",
      "transport": "http"
    }
  }
}

Claude Code

Run this outside an active Claude Code session:

claude mcp add --transport http zyfai https://mcp.zyf.ai/mcp

Claude

In Claude, open Customize → Connectors, add a custom connector named Zyfai, and set the remote MCP URL to https://mcp.zyf.ai/mcp. Select Continue, then sign in. Full click-path: Use Zyfai with AI.

Grok

Open grok.com/connectors, select New Connector → Custom, and enter the hosted endpoint. Complete Zyfai sign-in when prompted.

Grok Bot

Ask your Bot to add the custom MCP connection:

Add this MCP server: https://mcp.zyf.ai/mcp

Confirm the connection in Bot chat, complete Zyfai sign-in, and verify that the tools are available in the next message. See Grok Bot's app connection guide.

Read-only smoke test

After sign-in, run these prompts with a Zyfai account that has no funds:

1. Using Zyfai, show conservative USDC yield opportunities on Base. Expect opportunity data from Zyfai.
2. Using Zyfai, show my current positions. Expect an empty result for an account with no positions.

Try it

Start with public opportunity discovery:

Using Zyfai, show me conservative USDC opportunities on Base. Compare APY, TVL, protocol, and risk.

Then compare strategies:

Now compare those with the balanced strategy and explain the additional risk rather than recommending purely by APY.

After authentication:

Show my current Zyfai positions and earnings. Do not prepare any transaction.

For a controlled action flow:

Help me prepare a 1 USDC deposit on Base using the conservative strategy. Explain each step and ask before anything requiring a wallet signature.

Authentication and safety

Zyfai separates general discovery from personal account access.

• Opportunity and protocol discovery use public market and strategy data.
• Portfolio, position, earnings, history, and personalized tools require an authenticated Zyfai session.
• Supported write flows require authentication and may return a Zyfai signing URL.
• Connecting the MCP server does not transfer assets or give an AI custody of a wallet.
• The server never needs a seed phrase or raw private key from chat.
• Users should verify the chain, asset, amount, strategy, destination, and wallet request before signing.

OAuth challenges are returned through standard HTTP 401 and WWW-Authenticate responses so compatible clients can begin the authentication flow.

Documentation

Run locally

Requirements: Node.js 18+ and pnpm.

git clone https://github.com/ondefy/zyfai-mcp-server
cd zyfai-mcp-server
cp .env.example .env
pnpm install
pnpm run check
pnpm start

Local endpoints:

• MCP: http://localhost:3005/mcp
• Health: http://localhost:3005/health

Set ZYFAI_API_KEY in .env for live Zyfai API calls. See .env.example for authentication, backend, CORS, write-tool, and signing configuration.

For workspace-linked SDK development, local OAuth, integration testing, and the full repository architecture, read AGENTS.md.

Validate changes

pnpm run check

This runs TypeScript validation, the production build, and unit tests. Integration suites are opt-in; see AGENTS.md.

Related projects

• Zyfai
• Zyfai documentation
• @zyfai/sdk
• Zyfai SDK repository

This public server is separate from zyf-knowledge-mcp, Zyfai's internal code and documentation search service.

License

ISC