Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Actora — Agent Identity, Subscriptions & A2A

by sftgroupversion 0.2.2i★ 0iRuns in the cloud
Registry nameio.github.sftgroup/actora

How to install

What it does

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

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Crypto & blockchain

Install

Pick the AI app you use, then copy the settings.

Passed 5/5 checks · What you ask goes through the maker’s server (actora.codes) · ✓ Commands checked Nov 13, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 2 min

No key, nothing to install · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameActora — Agent Identity, Subscriptions & A2A
    Remote MCP server URL · Addresshttps://actora.codes/mcp

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  3. Turn it on in a chat

    +ConnectorsActora — Agent Identity, Subscriptions & A2A

  4. Try it

    Use Actora — Agent Identity, Subscriptions & A2A and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Actora — Agent Identity, Subscriptions & A2A or shows a Actora — Agent Identity, Subscriptions & A2A tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with ChatGPT, depending on your plan

Full MCP: ChatGPT Business, Enterprise or Edu on the web · Pro: connects with read/fetch permissions, so tools that change data may not work · Plus: not confirmed in OpenAI’s docs; if you see an add-custom-MCP option on the Plugins page you can try these steps · web only

  1. Open ChatGPT’s add-MCP page on the web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Fill in the name and address

    Enter a name, paste the address under Connection, tick the risk warning and click Create as a plugin

    Name · NameActora — Agent Identity, Subscriptions & A2A
    Connection · Addresshttps://actora.codes/mcp
  3. Pick Actora — Agent Identity, Subscriptions & A2A in a chat

    Start a new chat and pick Actora — Agent Identity, Subscriptions & A2A from your plugins before typing

  4. Try it

    Use Actora — Agent Identity, Subscriptions & A2A and tell me what you can do for me, then show me one thing

    ✓ If ChatGPT says it is using Actora — Agent Identity, Subscriptions & A2A or shows a Actora — Agent Identity, Subscriptions & A2A tool in the answer, you are connected

Menu names checked against OpenAI’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Claude Code · about 2 min

No key, nothing to install

  1. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  2. Paste this command and press Enter

    claude mcp add --transport http --scope user actora https://actora.codes/mcp
  3. Type /mcp in Claude Code

    You should see Actora — Agent Identity, Subscriptions & A2A listed as connected

  4. Try it

    Use Actora — Agent Identity, Subscriptions & A2A and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Actora — Agent Identity, Subscriptions & A2A or shows a Actora — Agent Identity, Subscriptions & A2A tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 2 min

No key, nothing to install

  1. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  2. Open the AI chat in Cursor in Agent mode

  3. Try it

    Use Actora — Agent Identity, Subscriptions & A2A and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Actora — Agent Identity, Subscriptions & A2A or shows a Actora — Agent Identity, Subscriptions & A2A tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 2 min

No key, nothing to install

  1. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  2. Open the AI chat in VS Code in Agent mode

  3. Try it

    Use Actora — Agent Identity, Subscriptions & A2A and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Actora — Agent Identity, Subscriptions & A2A or shows a Actora — Agent Identity, Subscriptions & A2A tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://actora.codes/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Actora — Agent Identity, Subscriptions & A2A💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user 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"
    }
  }
}

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
Apache-2.0
Connection
Runs in the cloud
Transport
streamable-http
Latest versioni
0.2.2
Published to registryi
Nov 8, 2026
Code last changedi
Nov 8, 2026
Maker
sftgroup
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

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

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 9, 2026. The maker wrote them, not us; we show them as plain text.

  • 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).

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 14, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account sftgroup, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 6 days ago

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • ✓ Pass

    Endpoint responds

    Responded in 716 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 53 tool descriptions and found no hidden instructions to the AI

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in with Google to post

User reviews

No reviews yet

Sign in with Google to write a review

Compared with others in Crypto & blockchaini

  • More stars than 0% of the other 1681 servers in this category
  • Published to the registry more recently than 88% of the other 1681 servers in this category
  • Basic checks equal to or better than 100% of the other 1681 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Actora — Agent Identity, Subscriptions & A2A safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed 6 days ago, and the latest version (0.2.2) reached the registry 6 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: Solana MCP by Vybe, Oracle3 prediction-market arbitrage checks, Polymarket Paper Trader

Others in the same category

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Solana MCP by Vybe

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

by vybenetworkGrowing★ 2.7K Stars for the whole repoUpdated 6 months ago

Runs in the cloud

Polymarket Paper Trader

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

by agent-nextGrowing↓ 226/wk★ 507Updated 29 days ago

Runs on your computer

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

@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 发布,搜

Only the beginning is shown; read the rest in the repo