Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Bewertungen und Benutzerkonten folgen in einem späteren Schritt.
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Actora — Agent Identity, Subscriptions & A2A

von sftgroupVersion 0.2.1i★ –iLäuft in der Cloud
Name in der Registryio.github.sftgroup/actora

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

  • Verbindung: Läuft in der Cloud
  • Transport: Streamable HTTP
  • Kategorie: Chat & E-Mail

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

  • Basischecks: 3 von 3 bestanden
  • Läuft auf dem Server des Entwicklers: Was du fragst, läuft über dessen Server.
  • Kann 52 Dinge (Tools) actora_identity_list, actora_identity_get, actora_identity_list_all, actora_identity_metadata …
  • Die Registry nennt keinen Schlüssel zum Eintragen.

Du brauchst

Welche App nutzt du?

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Funktioniert in Claude im Web, auf dem Desktop und auf dem Handy:

  1. Öffne Settings → Connectors
  2. Tippe auf Add custom connector
  3. Füge die Adresse unten ein und tippe auf Add
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Add2https://…3
https://actora.codes/mcp

Führe das in deinem Terminal aus

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

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

ChatGPT verbindet sich nur mit Servern im Internet:

  1. Öffne ChatGPT im Web → Settings → Connectors (Apps)
  2. Tippe auf Create oder Add (bei manchen Tarifen musst du zuerst Developer mode unter Advanced einschalten)
  3. Füge die Adresse unten ein, gib ihr einen Namen und speichere
  4. Wenn eine Anmeldung verlangt wird, melde dich beim Dienst des Entwicklers an
SettingsConnectors1+ Create2https://…3
https://actora.codes/mcp

Menünamen können sich je nach Tarif und mit der Zeit leicht unterscheiden.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 6. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen 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

    Subscribe to a plan. WRITE operation.

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

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto sftgroup bestätigt, dem das Repo gehört

  • … Noch nicht geprüft

    Wird noch gepflegt

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • … Noch nicht geprüft

    Hat eine Lizenz

    Dieses Repo haben wir noch nicht von GitHub gelesen

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 769 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 52 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Im Vergleich mit anderen in Chat & E-Maili

  • Mehr Sterne als 0 % der anderen 1765 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 92 % der anderen 1765 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 100 % der anderen 1765 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Actora — Agent Identity, Subscriptions & A2A sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.1) kam gestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL, also funktionieren auch Apps, die Remote-MCP-Server akzeptieren, zum Beispiel ChatGPT im Entwicklermodus.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Vexa, emailmd, MCP WhatsApp Cloud

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Vexa

von Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Läuft in der Cloud★ 2.949Apache-2.0Aktualisiert vor 2 Monaten
Installieren

emailmd

von anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer oder Cloud★ 1.385MITAktualisiert vor 31 Tagen
Installieren

MCP WhatsApp Cloud

von codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Läuft auf deinem Computer★ 277MITAktualisiert vor 5 Monaten
Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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

Nur der Anfang wird gezeigt; den Rest findest du im Repo

PopNx fragen