actora_identity_list
List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.
chainownerAddress必填io.github.sftgroup由 GitHub 账号 sftgroup 发布v0.2.1更新于 Nov 5, 2026
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 52 tools.
发布方自己的服务:Agent Identity
远程 Actora 网关 MCP 服务,通过 52 个工具提供 ERC-8004 代理身份、链上订阅、信誉、A2A 任务与代理对话能力。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.sftgroup%2Factora/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"actora-agent-identity-subscriptions-a2a": {
"type": "http",
"url": "https://actora.codes/mcp"
}
}
}Actora MCP 客户端包 — 类型化访问 Actora Gateway 的 MCP 服务(52 个工具):IdentityRegistry 读取、订阅套餐/操作、中心化 Agent(C-6,链下市场)发布/订阅、A2A、信誉、配置、端点、对话与并行任务管理。
与 @actora/sdk 的区别:SDK 直连区块链(读/写/事件),本包走 Gateway MCP 协议(工具化调用,无需 RPC 端点,生产地址由 Gateway 提供)。
三个入口共用同一套 JSON-RPC 2.0 实现,initialize / tools/list 不需要任何凭证。
客户端接入(以 /mcp/platform 为例;字段名以各客户端文档为准):
中心化 Agent(agents.source='central',负 ID,不发布在链上)订阅计划存于网关 DB(central_plans),但付费复用与链上完全相同的 x402 通道。MCP 提供中心化 Agent 的发布 / 更新 / 订阅购买 / 列表 / 订阅状态共 5 个工具:
等价于直接调用底层工具(通用 callTool,任何语言/HTTP 客户端可用):
发布 / 更新与订阅购买(WRITE,需 access_token 注册用户 JWT——MCP 的对话/中心化写工具不接受 B 端 api_key):
注意
- 负 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(显式传参优先,兼容旧调用方)注意
- 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"},属预期行为。
createPlan 仅接受 'day' | 'week' | 'month' | 'year'(合约 _periodToSeconds 只映射这四个值,其他字符串会静默回退 30 天)。{ _writeOp: true, contract, chain, args } 描述,交易签名/提交由调用方钱包完成。'sepolia'(默认,测试网)。fetch,无其他运行时依赖。服务端已托管在 https://actora.codes/mcp:MCP JSON-RPC 2.0,52 个工具,initialize / tools/list 无需鉴权。执行类工具的 JWT 支持两种来源(两者等价):
Authorization: Bearer <JWT>(推荐,目录/客户端只需配一个 header)access_token(兼容旧调用方;显式传参优先)按受众拆分的两个入口(同一套实现,工具子集不同):
本目录的 server.json 是官方 MCP Registry 清单(已按 2025-12-11 schema 校验)。三个服务已于 2026-11-04 以 0.2.0 发布,搜索 sftgroup 可检索到:
其他目录(Smithery / mcp.so / Glama / PulseMCP)均按 GitHub 仓库或该清单收录,提交时统一填:
兼容性:服务端当前协商到 MCP 2024-11-05(无 Mcp-Session-Id,无状态 POST)。新客户端请求 2025-03-26 时会回落到 2024-11-05,按规范可接受;若目录审核要求 Streamable HTTP 会话,需先补协议版本协商。
Apache License 2.0 — see LICENSE and NOTICE. The "Actora" name and logo are not licensed — see TRADEMARK.md.
来源:README.md,提交 1350ac6
List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.
chainownerAddress必填Get agent details — tokenURI, metadata, existence.
chainagentId必填List all agents with structured metadata (name, capabilities, skills, isActive). Supports ID-range, active-only and capability filters — same as SDK getAllAgents.
toIdchainfromIdactiveOnlycapabilitiesGet structured metadata for one agent: name, description, capabilities, skills, isActive, createdAt.
chainagentId必填Check whether an agent ID exists on-chain.
chainagentId必填Total number of agents registered.
chainRegister a new Agent on-chain. WRITE operation — returns tx payload.
chaintokenURI必填eciesEncryptedKey必填encryptedPayloadCid必填Get plan details: price, period, pay token, trial days.
chainplanId必填Check if a wallet has an active subscription for an agent.
chainagentId必填subscriberAddress必填Full subscription detail including trial info, escrow status.
chainsubscriptionId必填List all subscription IDs for a wallet.
chainuserAddress必填Subscribe to a plan. WRITE operation.
chainplanId必填valueWeiCancel a subscription. WRITE operation.
chainsubscriptionId必填Deprecated: ERC8004SubscriptionManager settles payments on subscribe/renew, so there is no escrow to release.
chainsubscriptionId必填Get current platform fee in bps.
chainCreate 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.
namechainpriceperiod必填agentId必填maxUsagepayTokenplanTypeusagePricedescriptiontotalUsageLimitList 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.
pagecategorypageSizeactiveOnlycapabilitiesCheck 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.
agentId必填subscriber必填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.
name必填tagsskillscategorydescriptionaccess_token必填capabilitiesUpdate a centralized agent you own (PATCH semantics — only provided fields change). Requires access_token (registered-user JWT). WRITE operation.
nametagsskillsagentId必填categoryisActivedescriptionaccess_token必填capabilitiesSubscribe 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 to verify and activate the subscription.
periodtxHashagentId必填priceWeisubscriber必填access_token必填Create an on-chain A2A task. WRITE operation.
chaintaskType必填inputData必填targetAgentId必填Get A2A task details.
chaintaskId必填Complete a task on-chain. WRITE operation.
chaintaskId必填outputData必填Get all task IDs for a wallet.
chainuserAddress必填Get agent A2A card: name, capabilities, supported tasks.
chainagentId必填Rate an agent (1-5). WRITE operation.
chainrating必填agentId必填commentAverage rating and review count.
chainagentId必填All reviews with reviewer, rating, comment, timestamp.
chainagentId必填Read an agent spec/config value by key from the platform DB (not the on-chain ConfigurationRegistry).
chainagentId必填configKey必填List all agent spec/config values for an agent from the platform DB.
chainagentId必填Config writes are owner-signed on the platform API (PATCH /api/v1/agents/:chain/:id); returns instructions. WRITE operation.
key必填chainvalue必填agentId必填dataTypeAll registered endpoints from the platform DB (includes pending/failed).
chainagentId必填Only live endpoints from the platform DB.
chainagentId必填Best available MCP endpoint URL from the platform DB.
chainagentId必填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).
access_token必填Get tenant profile, plan, quota. Requires access_token (registered-user JWT); `Authorization: Bearer` is injected automatically.
accessTokenaccess_tokenGateway health + chain contract addresses (BSC / Ethereum / Base).
无需输入参数。
Single-turn conversation with an agent (SSE stream collected into a reply). Requires access_token (registered-user JWT).
prompthistorymessage必填agent_idaccess_tokentenant_key_idCreate a conversation session (dialog container; idempotent). Requires access_token (registered-user JWT).
titleagent_idaccess_tokenCreate 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).
promptmessage必填agent_idsession_id必填access_tokentenant_key_idGet task detail by id (status, result, error). Requires access_token (registered-user JWT).
task_id必填access_tokenList all tasks of a session. Requires access_token (registered-user JWT).
session_id必填access_tokenCancel a task (queued → cancelled; running → aborted; terminal states are idempotent). Requires access_token (registered-user JWT).
task_id必填access_tokenGet the marketplace listing for an agent: visibility, pricing type, USD price, payment link. Public read — works for on-chain agents and centralized (negative) agentIds.
chain必填agentId必填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.
tagschain必填agentId必填endpointprotocolvisibilitypricingTypeaccess_token必填priceUsdCentspaymentLinkUrlUpdate pricing for an existing listing (subscription / per_call / free + USD cents). Requires access_token (owner JWT). WRITE operation.
chain必填agentId必填pricingTypeaccess_token必填priceUsdCentsRemove a listing (delist) and mark its endpoints as delisted. Requires access_token (owner JWT). WRITE operation.
chain必填agentId必填access_token必填Re-probe the primary endpoint of a listed agent (a2a or mcp) and return the liveness result. Requires access_token (owner JWT).
chain必填agentId必填access_token必填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.
chainagentId必填access_token必填List platform plans for B-side tenants (Free / Pro / Enterprise: quota, rate limit, concurrency, BYOK). Requires access_token (registered-user JWT).
access_token必填Token/tool-call usage summary and daily timeline for the current tenant. Requires access_token (registered-user JWT).
daysaccess_token必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
dev.agent-identity官方发布者
一个远程 MCP 服务器,为 AI 智能体提供专属电子邮箱、电话号码以及智能体之间的任务通道。

由 GitHub 账号 tfitzgerwitness 发布
一个远程 MCP 端点,为自主软件代理提供可选的持久身份状态。

由 GitHub 账号 jdhart81 发布
一个托管型注册表 MCP 服务器,让助手注册带内容寻址 DID 的代理身份、解析身份,并按能力发现其他代理。

由 GitHub 账号 flovoice53-tech 发布
为 AI 代理提供一次性邮箱和真实英国手机号,使其能自行完成并验证注册流程。

由 GitHub 账号 alvseek 发布
Munnin 是一个远程 MCP 服务器,为 AI 代理提供持久身份与记忆,并提供维护这些记忆的流程。
第三方服务 ── @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# ① 握手:应返回 protocolVersion=2024-11-05 与 serverInfocurl -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=9curl -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"}}}'{ "mcpServers": { "actora": { "url": "https://actora.codes/mcp/platform" }, "actora-tenant": { "url": "https://actora.codes/mcp/tenant", "headers": { "Authorization": "Bearer <registered-user JWT>" } } }}# Claude Codeclaude mcp add --transport http actora https://actora.codes/mcp/platformnpm install @actora/mcpimport { 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', {})// 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 }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 }# 发布中心化 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 }const mcp = new McpClient({ gatewayUrl: 'https://actora.codes', headers: { Authorization: 'Bearer <registered-user JWT>' },})mcp-publisher login github # 需 sftgroup 账号授权(命名空间 io.github.sftgroup)mcp-publisher publish server-platform.jsonmcp-publisher publish server-tenant.jsonmcp-publisher publish server.json # 同版本号不可覆盖,升版本后重发