关于 1inch MCP
1inch MCP 为 AI 助手和 Agent 提供文档检索与 Web3 产品工具,覆盖兑换、限价单、钱包数据和市场信息。配套 Agent Skills 提供各领域的调用说明与工作流。
主要功能
- 01搜索文档并获取 SDK 示例
- 02执行代币及跨链兑换
- 03创建和管理限价单
- 04访问钱包、市场及基础设施 API
- 05查询 Aqua 分析和可选请求日志
适用场景
- 01查找 1inch 文档或 SDK 示例
- 02执行代币兑换或跨链交易
- 03查看钱包资产及市场数据
- 04通过 WalletConnect 配对钱包
MCP 相关
远程 MCP 服务地址为 `https://api.1inch.com/mcp/protocol`,向客户端提供文档、交易、数据和其他 API 工具。部分公开工具无需认证;受保护工具使用 API 密钥或 OAuth。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.1inch.com/mcp/protocolclaude mcp add --transport http com-1inch-business https://api.1inch.com/mcp/protocol{"mcpServers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}在 Cursor 中打开{"servers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}在 VS Code 中打开{"mcpServers":{"com-1inch-business":{"type":"http","url":"https://api.1inch.com/mcp/protocol"}}}{"mcpServers":{"com-1inch-business":{"serverUrl":"https://api.1inch.com/mcp/protocol"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
10| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | number | 否 | 分页页码(默认 1) |
| limit | number | 否 | 每个集合的最大结果数(默认值为 10) |
| query | string | 是 | 搜索查询字符串 |
| include_body | boolean | 否 | 在结果中包含完整文档正文(默认值为 true)。设为 false 可缩减响应内容。 |
详细介绍
1inch AI
1inch AI 集成的公开分发中心 — Agent Skills、MCP 服务配置,以及面向 Claude、Cursor 和其他 AI 助手的市场列表。
MCP 服务
1inch MCP 服务托管于:
https://api.1inch.com/mcp/protocol
它提供文档搜索、SDK 示例、代币兑换、限价订单、经过身份验证的产品 API 访问、WalletConnect、Aqua 分析,以及(启用后)组织范围内的日志查询。完整文档:1inch MCP Server。
快速设置
Cursor
从 Cursor Marketplace 安装 1inch MCP。Skills 会自动从此仓库加载。若要在不使用 OAuth 的情况下访问经过身份验证的工具,请打开插件 → Setup → Edit Values,然后粘贴从 1inch Business Portal 获取的 API 密钥。将字段留空即可使用公开工具和 OAuth。
或者,在项目中创建 .cursor/mcp.json:
{
"mcpServers": {
"1inch-mcp": {
"url": "https://api.1inch.com/mcp/protocol"
}
}
}
Claude Code
claude mcp add --transport http --scope user 1inch-mcp https://api.1inch.com/mcp/protocol
VS Code(Copilot)
在项目中创建 .vscode/mcp.json:
{
"servers": {
"1inch-mcp": {
"type": "http",
"url": "https://api.1inch.com/mcp/protocol"
}
}
}
其他客户端
Claude Desktop、Windsurf、JetBrains、OpenAI Codex、Gemini CLI、ChatGPT、Grok 等的详细信息,请参阅完整设置指南。
Agent Skills
安装 1inch Skills,让你的 AI Agent 了解服务 URL、身份验证模式和准确的 product_api 调用方法:
npx skills add 1inch/1inch-ai
| Skill | 作用 |
|---|---|
1inch-mcp-server | 中心 — MCP URL、身份验证、客户端设置、工具概览 |
1inch-swap | 通过 swap 进行经典兑换 / Fusion / 跨链兑换 |
1inch-orderbook | 通过 orderbook 创建限价订单 |
1inch-wallet-data | 通过 product_api 获取投资组合、余额、历史记录、NFT 和代币 |
1inch-market-data | 通过 product_api 获取现货价格、Gas 价格和图表 |
1inch-infrastructure | 通过 product_api 获取 Web3 RPC、交易网关和域名 |
1inch-walletconnect | 非托管式 WalletConnect 配对 |
1inch-aqua | Aqua 策略分析 |
1inch-debug | 组织范围内的请求日志查询 |
Skills 按需加载(调用前约占用 30–50 个 Token)。对于具体任务,优先使用对应领域的 Skill — 例如,查询 Gas 价格时,1inch-market-data 会教你使用 GET /gas-price/v1.6/{chainId}。
请参阅 Agent Skills 规范。
仓库结构
.cursor-plugin/ Cursor Marketplace plugin (manifest, API-key setup values, MCP config)
.claude-plugin/ Claude Code plugin manifest
skills/ Agent Skills (agentskills.io)
1inch-mcp-server/ Hub skill (SKILL.md + AUTH/TOOLS references)
1inch-swap/ Swap workflows
1inch-orderbook/ Limit orders
1inch-wallet-data/ product_api recipes (Wallet & Data)
1inch-market-data/ product_api recipes (Market Data)
1inch-infrastructure/ product_api recipes (Infrastructure)
1inch-walletconnect/ WalletConnect
1inch-aqua/ Aqua analytics
1inch-debug/ Request log lookup
cursor/ Cursor plugin README and docs
claude/ Claude Connectors Directory pointer
assets/ Logo and branding
mcp.json MCP server configuration (remote URL)
server.json Official MCP Registry pointer
SECURITY.md Security policy and vulnerability reporting
身份验证
公开工具(search、list_examples、get_example,以及启用时的只读 aqua)无需身份验证。经过身份验证的工具(swap、orderbook、product_api 和可选的 debug)需要 API 密钥或 OAuth 登录。请参阅 MCP 产品文档。
从 1inch Business Portal 获取 API 密钥。
链接
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。