原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Actora — Agent Identity, Subscriptions & A2A

作者:sftgroup版本 0.2.2i★ 0i在云端运行
注册名称io.github.sftgroup/actora

安装方法

概览

作者提供的说明(英文原文)

ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 53 tools.

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在云端运行
  • 传输方式: Streamable HTTP
  • 分类: 加密货币与区块链

安装

选择你使用的 AI 应用,然后复制设置。

通过 4/4 项检查 · 你的提问会经过开发者的服务器(actora.codes)

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥,不用安装程序 · 在 claude.ai 或桌面应用设置一次,即可在聊天中使用 · 免费账户可添加 1 个

  1. 打开 Claude 的 Connectors 页面

    CustomizeConnectors

    CustomizeConnectors1+ Add2https://…3Add4
  2. 点击“+ Add” → “Add custom connector”,填写这 2 项

    把这里的内容复制到 Claude 中同名的输入框,然后点击 Continue

    Name · 名称Actora — Agent Identity, Subscriptions & A2A
    Remote MCP server URL · 地址https://actora.codes/mcp

    Authentication 保持 Claude 检测到的设置,然后点击 Add

  3. 在聊天中开启

    +ConnectorsActora — Agent Identity, Subscriptions & A2A

  4. 试一试

    用 Actora — Agent Identity, Subscriptions & A2A 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 Actora — Agent Identity, Subscriptions & A2A,或回答中出现 Actora — Agent Identity, Subscriptions & A2A 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

仅企业版 ChatGPT 可连接

适用于网页版 ChatGPT Business、Enterprise 或 Edu,需由工作区管理员或所有者添加 · 使用 Free、Plus 或 Pro:你的 ChatGPT 方案暂时无法自行连接 MCP

  1. 在网页版 ChatGPT 打开添加 MCP 的页面

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. 填写名称和地址

    输入名称,在 Connection 下粘贴地址,勾选风险提示,然后点击 Create as a plugin

    Name · 名称Actora — Agent Identity, Subscriptions & A2A
    Connection · 地址https://actora.codes/mcp
  3. 在聊天中选择 Actora — Agent Identity, Subscriptions & A2A

    开启新聊天,输入前先从插件列表中选择 Actora — Agent Identity, Subscriptions & A2A

  4. 试一试

    用 Actora — Agent Identity, Subscriptions & A2A 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 ChatGPT 说正在使用 Actora — Agent Identity, Subscriptions & A2A,或回答中出现 Actora — Agent Identity, Subscriptions & A2A 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  2. 粘贴这条命令并按 Enter

    claude mcp add --transport http actora https://actora.codes/mcp
  3. 在 Claude Code 中输入 /mcp

    应能看到 Actora — Agent Identity, Subscriptions & A2A 在列表中并显示已连接

  4. 试一试

    用 Actora — Agent Identity, Subscriptions & A2A 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 Actora — Agent Identity, Subscriptions & A2A,或回答中出现 Actora — Agent Identity, Subscriptions & A2A 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  2. 在 Cursor 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Actora — Agent Identity, Subscriptions & A2A 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 Actora — Agent Identity, Subscriptions & A2A,或回答中出现 Actora — Agent Identity, Subscriptions & A2A 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥,不用安装程序

  1. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  2. 在 VS Code 中以 Agent 模式打开 AI 聊天

  3. 试一试

    用 Actora — Agent Identity, Subscriptions & A2A 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 Actora — Agent Identity, Subscriptions & A2A,或回答中出现 Actora — Agent Identity, Subscriptions & A2A 的工具名称,就表示连接成功

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://actora.codes/mcp

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 Actora — Agent Identity, Subscriptions & A2A 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http actora https://actora.codes/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "actora": {
      "url": "https://actora.codes/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "actora": {
      "type": "http",
      "url": "https://actora.codes/mcp"
    }
  }
}

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

一览

每周下载量i
不在 npm/PyPI 上
许可证i
未注明许可证
连接方式
在云端运行
传输方式
streamable-http
最新版本i
0.2.2
发布到注册中心i
2026年11月8日
代码最后更新i
2026年11月8日
作者
sftgroup
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

通过互联网连接,适用于

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

全部应用及其优缺点 →

它能做什么

工具名称和描述与服务器在 2026年11月9日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • actora_identity_list

    List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.

  • actora_identity_get

    Get agent details — tokenURI, metadata, existence.

  • actora_identity_list_all

    List all agents with structured metadata (name, capabilities, skills, isActive). Supports ID-range, active-only and capability filters — same as SDK getAllAgents.

  • actora_identity_metadata

    Get structured metadata for one agent: name, description, capabilities, skills, isActive, createdAt.

  • actora_identity_exists

    Check whether an agent ID exists on-chain.

  • actora_identity_total_count

    Total number of agents registered.

  • actora_identity_register

    Register a new Agent on-chain. WRITE operation — returns tx payload.

  • actora_subscription_plans

    Get plan details: price, period, pay token, trial days.

  • actora_subscription_check

    Check if a wallet has an active subscription for an agent.

  • actora_subscription_detail

    Full subscription detail including trial info, escrow status.

  • actora_subscription_my_list

    List all subscription IDs for a wallet.

  • actora_subscription_subscribe

    Get the browser link to subscribe to a plan. The on-chain subscription is signed by the subscriber wallet in the browser — this tool moves no funds and does not subscribe by itself, so never report it as completed. Open authorizeUrl, then verify with actora_subscription_my_list.

  • actora_subscription_cancel

    Cancel a subscription. WRITE operation.

  • actora_subscription_release

    Deprecated: ERC8004SubscriptionManager settles payments on subscribe/renew, so there is no escrow to release.

  • actora_subscription_fee

    Get current platform fee in bps.

  • actora_subscription_create_plan

    Create a subscription plan for an agent. WRITE operation. period is one of "day" | "week" | "month" | "quarter" | "year"; planType 0=subscription (default), 1=usage-based, 2=hybrid.

  • actora_central_agent_list

    List centralized agents (source="central", off-chain, negative IDs — NOT on-chain NFTs). Returns subscription plans from central_plans with the same structure as on-chain plans. Public read.

  • actora_central_subscription_check

    Check whether a wallet has an active subscription for a centralized agent (negative agentId). Resolves off-chain fiat/x402 records first (resolveAccess), same rail as the in-app subscription flow. Public read.

  • actora_central_agent_create

    Create a centralized agent (source="central", off-chain, negative ID — NOT an on-chain NFT). Requires access_token (registered-user JWT). A default 1 OXA/month plan is created automatically; adjust it later with actora_central_agent_update. WRITE operation.

  • actora_central_agent_update

    Update a centralized agent you own (PATCH semantics — only provided fields change). Requires access_token (registered-user JWT). WRITE operation.

  • actora_central_subscription_subscribe

    Subscribe to a centralized agent via the x402 rail. Requires access_token (registered-user JWT). First call (without txHash) returns the payment instruction (amountWei / payTo / network); after the wallet completes the on-chain x402 transfer, call again with the resulting txHash

  • actora_a2a_create_task

    Create an on-chain A2A task. WRITE operation.

  • actora_a2a_get_task

    Get A2A task details.

  • actora_a2a_complete_task

    Complete a task on-chain. WRITE operation.

  • actora_a2a_my_tasks

    Get all task IDs for a wallet.

  • actora_a2a_agent_card

    Get agent A2A card: name, capabilities, supported tasks.

  • actora_agent_call

    Call a published agent and return its reply. Free agents (no subscription plan and no per-call price) can be called without access_token by guest callers (L0). Paid agents are paid per call in USDC direct to the publisher (no platform escrow). Two ways to get access: (a) an activ

  • actora_reputation_rate

    Rate an agent (1-5). WRITE operation.

  • actora_reputation_get

    Average rating and review count.

  • actora_reputation_reviews

    All reviews with reviewer, rating, comment, timestamp.

  • actora_config_get

    Read an agent spec/config value by key from the platform DB (not the on-chain ConfigurationRegistry).

  • actora_config_list

    List all agent spec/config values for an agent from the platform DB.

  • actora_config_set

    Config writes are owner-signed on the platform API (PATCH /api/v1/agents/:chain/:id); returns instructions. WRITE operation.

  • actora_endpoint_list

    All registered endpoints from the platform DB (includes pending/failed).

  • actora_endpoint_active

    Only live endpoints from the platform DB.

  • actora_endpoint_best_mcp

    Best available MCP endpoint URL from the platform DB.

  • actora_endpoint_status

    Owner-level endpoint health across all your agents — liveness counts (live / failed / pending / delisted), last probe result and retry time. Requires access_token (owner JWT).

  • actora_gateway_tenant

    Get tenant profile, plan, quota. Requires access_token (registered-user JWT); `Authorization: Bearer` is injected automatically.

  • actora_gateway_health

    Gateway health + chain contract addresses (BSC / Ethereum / Base).

  • actora_gateway_chat

    Single-turn conversation with an agent (SSE stream collected into a reply). Requires access_token (registered-user JWT).

  • actora_gateway_create_session

    Create a conversation session (dialog container; idempotent). Requires access_token (registered-user JWT).

  • actora_gateway_create_task

    Create a background task in a session (returns immediately with taskId; queued→running→done). May return 403 PARALLEL_TASKS_DISABLED. Requires access_token (registered-user JWT).

  • actora_gateway_get_task

    Get task detail by id (status, result, error). Requires access_token (registered-user JWT).

  • actora_gateway_list_tasks

    List all tasks of a session. Requires access_token (registered-user JWT).

  • actora_gateway_cancel_task

    Cancel a task (queued → cancelled; running → aborted; terminal states are idempotent). Requires access_token (registered-user JWT).

  • actora_listing_get

    Get the marketplace listing for an agent: visibility, pricing type, USD price, payment link. Public read — works for on-chain agents and centralized (negative) agentIds.

  • actora_listing_set

    Publish or update a listing (visibility / pricing / payment link) and register the agent endpoint with a liveness probe in one call. Requires access_token (owner JWT). Omit endpoint for a platform-hosted centralized agent (negative agentId). WRITE operation.

  • actora_listing_price

    Update pricing for an existing listing (subscription / per_call / free + USD cents). Requires access_token (owner JWT). WRITE operation.

  • actora_listing_delist

    Remove a listing (delist) and mark its endpoints as delisted. Requires access_token (owner JWT). WRITE operation.

  • actora_endpoint_probe

    Re-probe the primary endpoint of a listed agent (a2a or mcp) and return the liveness result. Requires access_token (owner JWT).

  • actora_payload_key_list

    List payload-key records for an agent you own (public key, mode, chain, export count — never the private key). Requires access_token. Exporting/decrypting keys is not exposed over MCP.

  • actora_tenant_plans

    List platform plans for B-side tenants (Free / Pro / Enterprise: quota, rate limit, concurrency, BYOK). Requires access_token (registered-user JWT).

  • actora_tenant_usage

    Token/tool-call usage summary and daily timeline for the current tenant. Requires access_token (registered-user JWT).

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月11日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 sftgroup 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于3天前

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • ✓ 通过

    端点有响应

    在 716 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 53 个工具描述,未发现针对 AI 的隐藏指令

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

使用 Google 登录后发帖

用户评价

还没有评价

用 Google 登录后写评价

与“加密货币与区块链”中的其他服务器比较i

  • 星标数多于此分类中其他 1642 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 1642 个服务器的 94% 更新
  • 基础检查结果等于或优于此分类中其他 1642 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Actora — Agent Identity, Subscriptions & A2A 安全吗?

它在 4 项适用的基础检查中通过了 4 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在作者的云端运行。通过互联网连接,无需安装,但你发送的内容会经过作者的服务器。

它还在维护吗?

GitHub 仓库最后更新于3天前,最新版本(0.2.2)于3天前进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,因此也能用于支持远程 MCP 的应用,例如 ChatGPT Business 及以上方案。

有什么可以替代它?

同一分类中有:Solana MCP by Vybe, Oracle3 prediction-market arbitrage checks, Polymarket Paper Trader

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Solana MCP by Vybe

Solana MCP developer toolkit: wallets, trades, markets, PnL, transfers, onchain, swaps & API tools.

作者:vybenetwork广泛使用★ 2599 整个仓库的星标6个月前更新

在云端运行

Oracle3 prediction-market arbitrage checks

Kalshi and Polymarket data, venue fees, no-arbitrage checks and paper execution for AI agents.

作者:YichengYang-Ethan正在增长↓ 35/周★ 56842天前更新

在你的电脑上运行

Polymarket Paper Trader

Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.

作者:agent-next正在增长↓ 226/周★ 50426天前更新

在你的电脑上运行

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@actora/mcp

Actora MCP 客户端包 — 类型化访问 Actora Gateway 的 MCP 服务(52 个工具):IdentityRegistry 读取、订阅套餐/操作、中心化 Agent(C-6,链下市场)发布/订阅、A2A、信誉、配置、端点、对话与并行任务管理。

第三方服务 ── @actora/mcp ──► POST <GATEWAY>/mcp (MCP JSON-RPC 2.0)

├─ actora_identity_* 链上 Agent 读取 ├─ actora_subscription_* 订阅套餐 / 写操作描述 ├─ actora_central_* 中心化 Agent(链下,负 ID):发布 / 更新 / 列表 / 订阅状态 / 订阅购买 ├─ actora_a2a_* / reputation / config / endpoint ├─ actora_gateway_health / tenant └─ actora_gateway_chat / create_session / create_task / get_task / list_tasks / cancel_task

与 @actora/sdk 的区别:SDK 直连区块链(读/写/事件),本包走 Gateway MCP 协议(工具化调用,无需 RPC 端点,生产地址由 Gateway 提供)。

3 分钟接入(远程 HTTP,无需安装)

三个入口共用同一套 JSON-RPC 2.0 实现,initialize / tools/list 不需要任何凭证。

# ① 握手:应返回 protocolVersion=2024-11-05 与 serverInfo

curl -s -X POST https://actora.codes/mcp/platform -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"0"}}}'

→ {"result":{"protocolVersion":"2024-11-05","serverInfo":{"name":"actora-platform","version":"0.2.0"},"capabilities":{"tools":{}}}}

② 工具数:/mcp=52 · /mcp/platform=43 · /mcp/tenant=9

curl -s -X POST https://actora.codes/mcp/platform -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \ | python3 -c 'import sys,json;print(len(json.load(sys.stdin)"result"))'

③ 调用一个只读工具(匿名可用)

curl -s -X POST https://actora.codes/mcp/platform -H 'Content-Type: application/json' \ -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"actora_identity_total_count","arguments":{"chain":"bsc"}}}'

→ {"content":[{"type":"text","text":"{\"totalAgents\": 22, \"chain\": \"BSC\", \"chainId\": 56}"}],"isError":false}

④ 需要身份的租户/对话工具:带注册用户 JWT(目录型客户端只需配一个 header)

curl -s -X POST https://actora.codes/mcp/tenant -H 'Content-Type: application/json' \ -H "Authorization: Bearer $ACTORA_JWT" \ -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"actora_gateway_chat","arguments":{"message":"hello"}}}'

客户端接入(以 /mcp/platform 为例;字段名以各客户端文档为准):

{

"mcpServers": { "actora": { "url": "https://actora.codes/mcp/platform" }, "actora-tenant": { "url": "https://actora.codes/mcp/tenant", "headers": { "Authorization": "Bearer " } } } }

# Claude Code

claude mcp add --transport http actora https://actora.codes/mcp/platform

Add to Cursor / Cline

仓库根已带 Cursor 插件清单:.cursor-plugin/plugin.json(含 variables 声明)+ mcp.json,装好后 MCP 服务名显示为 plugin-actora-platform。

客户端安装鉴权
CursorMarketplace 搜索 Actora(审核中);现在也可在 Cursor Settings → MCP 手动添加 https://actora.codes/mcp/platform插件变量 ACTORA_TOKEN,在 Plugins → Configure 中填写
Cline见 llms-install.md:面板 → MCP Servers → Remote Servers → URL 填 https://actora.codes/mcp/platform,Transport 选 Streamable HTTP无需凭证;写工具再加 Authorization header

mcp.json 里只有占位符,不含任何密钥:

{

"mcpServers": { "platform": { "url": "https://actora.codes/mcp/platform", "headers": { "Authorization": "Bearer ${ACTORA_TOKEN}" } } } }

ACTORA_TOKEN 不是必填项:留空即可匿名使用全部只读工具,只有需要账号的写工具会返回 access_token ... required。

安装

npm install @actora/mcp

快速开始

import { McpClient } from '@actora/mcp'

const mcp = new McpClient({ gatewayUrl: 'https://actora.codes', // Actora Gateway })

// 握手 + 工具列表 const info = await mcp.initialize() console.log('server:', info) // { name, version }

const tools = await mcp.listTools() console.log('工具数:', tools.length) // 52

// 批量查询 Agent(等价 SDK getAllAgents) const { agents, total } = await mcp.listAgents({ fromId: 1, toId: total, activeOnly: true }) for (const a of agents) { console.log(a.agentId, a.metadata.name, a.metadata.capabilities, a.metadata.isActive) }

// 单个元数据 / 总数 const meta = await mcp.getAgentMetadata(1) const count = await mcp.totalAgents()

// 订阅套餐(price 为 wei 十进制字符串) const plan = await mcp.getPlan(1) // → { planId: 1, agentId: 1, creator, price: "10000000000000000", period, active, payToken, trialDays }

// WRITE:返回待签名交易描述(需用钱包签名提交,包内不直接发交易) const op = await mcp.createPlan({ agentId: 2, price: '10000000000000000', period: 'month' }) // → { _writeOp: true, contract, chain, args: { agentId, price, period, ... } }

// 通用调用:任何工具(a2a / reputation / config / endpoint 等) const status = await mcp.callTool('actora_gateway_health', {})

中心化 Agent(C-6,链下市场)用法示例

中心化 Agent(agents.source='central',负 ID,不发布在链上)订阅计划存于网关 DB(central_plans),但付费复用与链上完全相同的 x402 通道。MCP 提供中心化 Agent 的发布 / 更新 / 订阅购买 / 列表 / 订阅状态共 5 个工具:

// 1. 中心化 Agent 列表 + 订阅计划(与链上 subscriptionPlans 同一响应结构)

const { agents, total } = await mcp.centralAgents({ activeOnly: true, category: 'finance', page: 1, pageSize: 20, }) // agents[0] → { id: -3, name, owner, description, category, isActive, subscriptionPlans: [...] } // plan → { planId, price: "1000000000000000000", period: "month", payToken: "native", isActive, ... }

// 2. 订阅状态检查(resolveAccess 链下优先 —— 与 App 订阅守卫同一判定) const { active } = await mcp.centralSubscriptionCheck('0x…', agents[0].id) // → { active: true, subscriber: '0x…', agentId: -3 }

等价于直接调用底层工具(通用 callTool,任何语言/HTTP 客户端可用):

curl -s -X POST https://actora.codes/mcp \

-H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call", "params":{"name":"actora_central_agent_list", "arguments":{"activeOnly":true,"pageSize":20}}}'

→ { agents: [...], total, page, pageSize }

curl -s -X POST https://actora.codes/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call", "params":{"name":"actora_central_subscription_check", "arguments":{"subscriber":"0x…","agentId":-3}}}'

→ { active: true, subscriber: '0x…', agentId: -3 }

发布 / 更新与订阅购买(WRITE,需 access_token 注册用户 JWT——MCP 的对话/中心化写工具不接受 B 端 api_key):

# 发布中心化 Agent(C-6,链下):自动创建默认月度计划

curl -s -X POST https://actora.codes/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":3,"method":"tools/call", "params":{"name":"actora_central_agent_create", "arguments":{"access_token":" ","name":"My Agent", "description":"...","capabilities":["chat","trading"]}}}'

→ { id: -N, name, owner, ... }

更新 / 上架 / 下架自己发布的中心化 Agent(仅提供变化的字段)

curl -s -X POST https://actora.codes/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":4,"method":"tools/call", "params":{"name":"actora_central_agent_update", "arguments":{"access_token":" ","agentId":-3,"isActive":true}}}'

中心化订阅购买(x402):首次调用返回付款指令(amountWei / payTo / network),

钱包完成链上转账后携 txHash 再次调用以验证并开通

curl -s -X POST https://actora.codes/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":5,"method":"tools/call", "params":{"name":"actora_central_subscription_subscribe", "arguments":{"access_token":" ","subscriber":"0x…","agentId":-3,"period":"month"}}}'

→ { paymentRequired: true, amountWei, payTo, network, instructions }

注意

- 负 ID 是中心化 Agent 的标识,不要传给链上工具(actora_identity_* / actora_subscription_*)——那些工具读的是链上合约。

- 中心化 Agent 的发布 / 更新 / 订阅购买(actora_central_agent_create / actora_central_agent_update / actora_central_subscription_subscribe)均需 access_token 注册用户 JWT。周期订阅付费也可用 SDK SubscriptionPayments.pay({ method:'x402', agentId, planId, period, priceWei })(v0.11.10+)或网关 REST 完成。

鉴权

只读工具(actora_identity_*、actora_subscription_* 查询、信誉/端点读取等)匿名可用。需要身份的写工具与租户/对话/任务工具要求注册用户 JWT,两种来源等价:

  • Authorization: Bearer (推荐,目录型客户端只需配一个 header)
  • 工具参数 access_token(显式传参优先,兼容旧调用方)
const mcp = new McpClient({

gatewayUrl: 'https://actora.codes', headers: { Authorization: 'Bearer ' }, })

注意

- MCP 不接受 B 端 api_key(actora_sk_…,X-Api-Key)——那把钥匙只用于 REST /api/v1。MCP 的对话/任务工具只认注册用户 JWT。

- Authorization: Bearer 会被注入为工具参数 access_token;actora_gateway_tenant 同时接受 access_token(推荐)与历史参数名 accessToken。

- 未带/无效 JWT 时,工具返回 {"error":"HTTP 401","detail":"Invalid or expired token"},属预期行为。

API 一览

方法对应 MCP 工具说明
initialize() / listTools() / callTool()—底层 MCP 协议
listAgents({chain,fromId,toId,activeOnly,capabilities})actora_identity_list_all批量查询 + 筛选
getAgentMetadata(agentId, chain?)actora_identity_metadata单 Agent 结构化元数据
totalAgents(chain?)actora_identity_total_count总注册数
agentExists(agentId, chain?)actora_identity_exists存在性检查
agentsOfOwner(owner, chain?)actora_identity_list钱包拥有的 Agent IDs
getPlan(planId, chain?)actora_subscription_plans套餐详情
createPlan({agentId,price,period,...})actora_subscription_create_plan创建套餐(WRITE)
subscribe(planId, {valueWei})actora_subscription_subscribe订阅(WRITE)
cancelSubscription(id)actora_subscription_cancel取消订阅(WRITE,即时生效、无退款)
~~releaseFunds(id)~~actora_subscription_release已废弃:v3 无 escrow,调用返回不支持错误
checkSubscription(sub, agentId)actora_subscription_check订阅有效性(链上)
centralAgents({activeOnly,category,capabilities,page,pageSize})actora_central_agent_list中心化 Agent 列表 + 计划(链下,C-6)
centralSubscriptionCheck(sub, agentId)actora_central_subscription_check中心化 Agent 订阅有效性(resolveAccess 链下优先)
centralAgentCreate({name,...})actora_central_agent_create发布中心化 Agent(WRITE,需 access_token)
centralAgentUpdate({agentId,...})actora_central_agent_update更新/上架/下架中心化 Agent(WRITE,需 access_token)
centralSubscriptionSubscribe({agentId,subscriber,period,txHash})actora_central_subscription_subscribe中心化订阅购买(x402,WRITE,需 access_token)
subscriptionDetail(id) / mySubscriptions(addr)actora_subscription_detail/my_list订阅详情/列表
platformFee(chain?)actora_subscription_fee平台费率(bps)
gatewayHealth() / gatewayTenant(accessToken?)actora_gateway_health/tenantGateway 状态 / 租户信息(JWT)
对话/任务(callTool)actora_gateway_chat / ..._create_session / ..._create_task / ..._get_task / ..._list_tasks / ..._cancel_task单轮对话与并行任务管理(需 access_token JWT 参数)

关键约定

  • period:createPlan 仅接受 'day' | 'week' | 'month' | 'year'(合约 _periodToSeconds 只映射这四个值,其他字符串会静默回退 30 天)。
  • price:wei 十进制字符串(避免精度丢失)。
  • WRITE 工具:返回 { _writeOp: true, contract, chain, args } 描述,交易签名/提交由调用方钱包完成。
  • chain:'sepolia'(默认,测试网)。
  • Node 18+ / 浏览器:依赖原生 fetch,无其他运行时依赖。

完整服务端工具与协议

见 MCP 接入文档 与 SDK 集成示例。

公开目录登记(服务端分发)

服务端已托管在 https://actora.codes/mcp:MCP JSON-RPC 2.0,52 个工具,initialize / tools/list 无需鉴权。执行类工具的 JWT 支持两种来源(两者等价):

  • `Authorization: Bearer `(推荐,目录/客户端只需配一个 header)
  • 工具参数 access_token(兼容旧调用方;显式传参优先)

按受众拆分的两个入口(同一套实现,工具子集不同):

入口工具数面向清单
/mcp52全量(兼容旧调用方)server.json
/mcp/platform43Agent 开发者:身份 / 订阅 / 上架定价 / 端点探活 / A2A / 信誉server-platform.json
/mcp/tenant9B 端:托管对话 / 会话 / 任务 / 套餐 / 用量server-tenant.json

本目录的 server.json 是官方 MCP Registry 清单(已按 2025-12-11 schema 校验)。三个服务已于 2026-11-04 以 0.2.0 发布,搜

只显示了开头部分;其余内容请在仓库中阅读