IntroductionDevelop with AI

0x Agent Skills

View as Markdown

Give your AI coding agent full knowledge of the 0x APIs with a single command. Once installed, your agent knows every endpoint, authentication method, and integration pattern for token swaps.

Compatible with Claude Code, Cursor, GitHub Copilot, and any agent that supports the Agent Skills specification.

Install

$npx skills add 0xProject/0x-ai
SkillAuthBest for
0x-apiAPI keyToken swaps using 0x Swap and Gasless APIs on any supported EVM chain. A 0x API key is required.

What your agent learns

The 0x-api skill covers everything needed to build production-ready swap integrations:

  • Swap API v2: Token swaps across all supported EVM chains. Both AllowanceHolder and Permit2 flows.
  • Gasless API v2: Swaps with no native token (e.g. ETH) required for gas.
  • Language support: TypeScript and Python code examples ready to drop into your project.
  • Error handling: Common failure modes and how to recover from them
  • v1 → v2 migration: A clear path for upgrading existing 0x integrations

Getting started

You’ll need a 0x API key — sign up free at the 0x Dashboard. Set it as an environment variable and your agent takes it from there.

Once the skill is installed, activate it in any agent session:

/0x-api

MCP Server

Alongside the skill, 0x provides an MCP server that gives your agent on-demand access to the latest 0x documentation and API references. This keeps your agent current even when docs have changed since its training cutoff.

The MCP server is set up automatically during npx skills add. To configure it manually:

1{
2  "mcpServers": {
3    "0x-mcp": {
4      "type": "url",
5      "url": "https://docs.0x.org/_mcp/server"
6    }
7  }
8}

Skills vs. MCP — what’s the difference?

They solve different problems and work well together:

Agent SkillsMCP Server
RoleEmbeds API knowledge so the agent can write correct codeLets the agent fetch live docs and references on demand
Triggered whenThe agent is writing code that calls 0x APIsThe agent needs to verify current endpoints or parameters
ResultCode that follows 0x patterns and best practicesUp-to-date documentation in the conversation context

Next steps