Actora Platform MCP server
Commit Nov 8, 2026Enables AI clients to manage agent identities, subscriptions, centralized agent marketplaces, and parallel task management via the Actora Gateway.
Also known as sftgroup/actora-mcp, actora-platform
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.2.2
- Last commit
- Nov 8, 2026
- License
- Apache-2.0
What is Actora Platform MCP?
Actora Platform enables AI clients to manage agent identities, subscriptions, centralized agent marketplaces, and parallel task management via the Actora Gateway.
Summary generated from the project's README
About Actora Platform MCP server
The Actora Platform MCP server provides a comprehensive interface for managing AI agent identities, subscriptions, and marketplace operations through the Actora Gateway. It allows developers to interact with both on-chain agent registries and a centralized off-chain marketplace for agents. The server is accessed remotely via HTTP using the MCP JSON-RPC 2.0 protocol, making it compatible with clients like Claude Code, Cursor, and Cline.
Users can utilize 52 distinct tools to perform tasks ranging from reading agent metadata and reputation to managing parallel tasks and chat sessions. While read-only tools like identity and subscription queries are available anonymously, write operations and tenant-specific features require a registered user JWT passed via an Authorization header. This setup enables sophisticated agent-to-agent interactions and centralized agent publishing without requiring direct blockchain RPC endpoints.
Written from the project's README. Every use case is checked against a quote from it.
How to install Actora Platform MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Actora Platform MCP in Claude Code
$ claude mcp add --transport http actora-platform https://actora.codes/mcp/platformInstall Actora Platform MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"actora-platform": {
"url": "https://actora.codes/mcp/platform"
}
}
}Install Actora Platform MCP in VS Code
.vscode/mcp.json
{
"servers": {
"actora-platform": {
"type": "http",
"url": "https://actora.codes/mcp/platform"
}
}
}Install Actora Platform MCP in VS Code CLI
$ code --add-mcp '{"name":"actora-platform","type":"http","url":"https://actora.codes/mcp/platform"}'Install Actora Platform MCP in Codex
$ codex mcp add actora-platform --url https://actora.codes/mcp/platformInstall Actora Platform MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.actora-platform] url = "https://actora.codes/mcp/platform"
Install Actora Platform MCP in Gemini CLI
$ gemini mcp add -s user --transport http actora-platform https://actora.codes/mcp/platformInstall Actora Platform MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"actora-platform": {
"url": "https://actora.codes/mcp/platform",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesftgroup/actora-mcp is public and reachablegithub.com/sftgroup/actora-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/sftgroup/actora-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2024-11-05 in 181 msPass
README
View on GitHub@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"]["tools"]))'
# ③ 调用一个只读工具(匿名可用)
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 <registered-user JWT>" }
}
}
}
# 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。
| 客户端 | 安装 | 鉴权 |
|---|---|---|
| Cursor | Marketplace 搜索 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":"<user-jwt>","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":"<user-jwt>","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":"<user-jwt>","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。周期订阅付费也可用 SDKSubscriptionPayments.pay({ method:'x402', agentId, planId, period, priceWei })(v0.11.10+)或网关 REST 完成。
鉴权
只读工具(actora_identity_*、actora_subscription_* 查询、信誉/端点读取等)匿名可用。需要身份的写工具与租户/对话/任务工具要求注册用户 JWT,两种来源等价:
Authorization: Bearer <JWT>(推荐,目录型客户端只需配一个 header)- 工具参数
access_token(显式传参优先,兼容旧调用方)
const mcp = new McpClient({
gatewayUrl: 'https://actora.codes',
headers: { Authorization: 'Bearer <registered-user JWT>' },
})
注意
- 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/tenant |
Gateway 状态 / 租户信息(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,无其他运行时依赖。
完整服务端工具与协议
公开目录登记(服务端分发)
服务端已托管在 https://actora.codes/mcp:MCP JSON-RPC 2.0,52 个工具,initialize / tools/list 无需鉴权。执行类工具的 JWT 支持两种来源(两者等价):
Authorization: Bearer <JWT>(推荐,目录/客户端只需配一个 header)- 工具参数
access_token(兼容旧调用方;显式传参优先)
按受众拆分的两个入口(同一套实现,工具子集不同):
| 入口 | 工具数 | 面向 | 清单 |
|---|---|---|---|
/mcp |
52 | 全量(兼容旧调用方) | server.json |
/mcp/platform |
43 | Agent 开发者:身份 / 订阅 / 上架定价 / 端点探活 / A2A / 信誉 | server-platform.json |
/mcp/tenant |
9 | B 端:托管对话 / 会话 / 任务 / 套餐 / 用量 | server-tenant.json |
本目录的 server.json 是官方 MCP Registry 清单(已按 2025-12-11 schema 校验)。三个服务已于 2026-11-04 以 0.2.0 发布,搜索 sftgroup 可检索到:
mcp-publisher login github # 需 sftgroup 账号授权(命名空间 io.github.sftgroup)
mcp-publisher publish server-platform.json
mcp-publisher publish server-tenant.json
mcp-publisher publish server.json # 同版本号不可覆盖,升版本后重发
其他目录(Smithery / mcp.so / Glama / PulseMCP)均按 GitHub 仓库或该清单收录,提交时统一填:
| 字段 | 值 |
|---|---|
| 远程地址 | https://actora.codes/mcp |
| 传输 | Streamable HTTP |
| 仓库 | https://github.com/sftgroup/actora-mcp |
| 图标 | https://actora.codes/icon-512.png |
兼容性:服务端当前协商到 MCP 2024-11-05(无 Mcp-Session-Id,无状态 POST)。新客户端请求 2025-03-26 时会回落到 2024-11-05,按规范可接受;若目录审核要求 Streamable HTTP 会话,需先补协议版本协商。
License
Apache License 2.0 — see LICENSE and NOTICE. The "Actora" name and logo are not licensed — see TRADEMARK.md.
Actora Platform MCP questions
How do I add Actora Platform MCP to Claude Code?
Run claude mcp add --transport http actora-platform https://actora.codes/mcp/platform in your terminal. Add --scope user to make it available in every project.
How do I add Actora Platform MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How are write operations handled in MCP?
Write tools return a transaction description (including contract, chain, and arguments), which the caller must then sign and submit using their own wallet.