Actora Tenant — Hosted Chat, Tasks & Usage

io.github.sftgroupPublished by GitHub account sftgroupv0.2.1Updated Nov 5, 2026

Actora B-side tools: hosted chat, sessions, tasks, tenant plan and usage.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsAI & ML

Overview

AI-generated overview

Hosted Actora tenant endpoint that lets an assistant chat with agents, run and manage background tasks in sessions, and check plan and usage.

What you can do
  • Chat with an agent in a single turn and create idempotent conversation sessions
  • Create background tasks in a session, then get, list or cancel them by id
  • Read the tenant profile, plan and quota
  • List platform plans (Free, Pro, Enterprise) with quota, rate limit, concurrency and BYOK
  • Summarize token and tool-call usage with a daily timeline
When to use it
Use it when you want an assistant to talk to Actora-hosted agents and run longer background work as queued tasks, or to check a tenant's plan, quota and consumption. It is a hosted endpoint, so nothing needs to be installed locally.
Requirements
Remote streamable HTTP endpoint at actora.codes (tenant path). Every listed tool needs a registered-user JWT, supplied as an Authorization Bearer header or an access_token tool argument. No local runtime, environment variables or package install is required.
Before you install
All nine tools require a registered-user JWT; without a valid one they return HTTP 401. The README notes that MCP does not accept the B-side api_key, only the user JWT. Task creation may be refused with 403 PARALLEL_TASKS_DISABLED, and cancel_task changes task state. The broader package also covers paid subscriptions and write operations, which are outside this tenant endpoint.

Installation

In SourceWeft

  1. Open Actora Tenant — Hosted Chat, Tasks & Usage in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.sftgroup%2Factora-tenant/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "actora-tenant-hosted-chat-tasks-usage": {
      "type": "http",
      "url": "https://actora.codes/mcp/tenant"
    }
  }
}

README

@actora/mcp

[CI]

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 不需要任何凭证。

bash
# ① 握手：应返回 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"}}}'

客户端接入（以 /mcp/platform 为例；字段名以各客户端文档为准）：

json
{  "mcpServers": {    "actora": { "url": "https://actora.codes/mcp/platform" },    "actora-tenant": {      "url": "https://actora.codes/mcp/tenant",      "headers": { "Authorization": "Bearer <registered-user JWT>" }    }  }}
bash
# Claude Codeclaude mcp add --transport http actora https://actora.codes/mcp/platform

安装

bash
npm install @actora/mcp

快速开始

typescript
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 个工具：

typescript
// 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 客户端可用）：

bash
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）：

bash
# 发布中心化 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。周期订阅付费也可用 SDK SubscriptionPayments.pay({ method:'x402', agentId, planId, period, priceWei })（v0.11.10+）或网关 REST 完成。

鉴权

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

  • Authorization: Bearer <JWT>（推荐，目录型客户端只需配一个 header）
  • 工具参数 access_token（显式传参优先，兼容旧调用方）
typescript
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) / releaseFunds(id)actora_subscription_cancel/release取消/释放（WRITE）
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 <JWT>（推荐，目录/客户端只需配一个 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 发布，搜索 sftgroup 可检索到：

bash
mcp-publisher login github   # 需 sftgroup 账号授权（命名空间 io.github.sftgroup）mcp-publisher publish server-platform.jsonmcp-publisher publish server-tenant.jsonmcp-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.

Source: README.md at commit 1350ac6

Tools

9

actora_gateway_tenant

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

ParametersaccessTokenaccess_token

actora_gateway_chat

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

Parametersprompthistorymessagerequiredagent_idaccess_tokentenant_key_id

actora_gateway_create_session

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

Parameterstitleagent_idaccess_token

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

Parameterspromptmessagerequiredagent_idsession_idrequiredaccess_tokentenant_key_id

actora_gateway_get_task

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

Parameterstask_idrequiredaccess_token

actora_gateway_list_tasks

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

Parameterssession_idrequiredaccess_token

actora_gateway_cancel_task

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

Parameterstask_idrequiredaccess_token

actora_tenant_plans

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

Parametersaccess_tokenrequired

actora_tenant_usage

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

Parametersdaysaccess_tokenrequired

Version history

2
  1. v0.2.1LatestNov 5, 2026
  2. v0.2.0Nov 4, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts