Actora — Agent Identity, Subscriptions & A2A
ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 52 tools.
사용해야 할까요
품질 및 안전성
발견 사항 (7)
- LOWactora_identity_total_count에서
- LOWactora_endpoint_list에서
- LOWactora_endpoint_active에서
- LOWactora_endpoint_best_mcp에서
- LOWactora_subscription_create_plan에서
- LOWactora_central_subscription_check에서
- LOWactora_central_subscription_subscribe에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"actora": {
"url": "https://actora.codes/mcp"
}
}
}원격 엔드포인트
https://actora.codes/mcpstreamable-http할 수 있는 일
도구 목록
도구 (52)
🟢actora_identity_list(chain, ownerAddress)
List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"ownerAddress": {
"type": "string",
"description": "Ethereum wallet address (0x...)"
}
},
"required": [
"ownerAddress"
]
}🟢actora_identity_get(chain, agentId)
Get agent details — tokenURI, metadata, existence.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent numeric ID"
}
},
"required": [
"agentId"
]
}🟢actora_identity_list_all(chain, fromId, toId, activeOnly, capabilities)
List all agents with structured metadata (name, capabilities, skills, isActive). Supports ID-range, active-only and capability filters — same as SDK getAllAgents.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"fromId": {
"type": "integer",
"description": "Start Agent ID (default 1)"
},
"toId": {
"type": "integer",
"description": "End Agent ID (default: last agent)"
},
"activeOnly": {
"type": "boolean",
"description": "Only return isActive=true agents"
},
"capabilities": {
"type": "string",
"description": "Comma-separated capability filter, e.g. \"trading,analysis\""
}
}
}🟢actora_identity_metadata(chain, agentId)
Get structured metadata for one agent: name, description, capabilities, skills, isActive, createdAt.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent numeric ID"
}
},
"required": [
"agentId"
]
}🟢actora_identity_exists(chain, agentId)
Check whether an agent ID exists on-chain.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}🟢actora_identity_total_count(chain)
Total number of agents registered.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
}
}
}🟡actora_identity_register(chain, tokenURI, encryptedPayloadCid, eciesEncryptedKey)
Register a new Agent on-chain. WRITE operation — returns tx payload.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"tokenURI": {
"type": "string",
"description": "IPFS URI (ipfs://...)"
},
"encryptedPayloadCid": {
"type": "string",
"description": "IPFS CID of encrypted payload"
},
"eciesEncryptedKey": {
"type": "string",
"description": "Hex ECIES-encrypted AES key"
}
},
"required": [
"tokenURI",
"encryptedPayloadCid",
"eciesEncryptedKey"
]
}🟢actora_subscription_plans(chain, planId)
Get plan details: price, period, pay token, trial days.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"planId": {
"type": "integer",
"description": "Plan ID"
}
},
"required": [
"planId"
]
}🟢actora_subscription_check(chain, subscriberAddress, agentId)
Check if a wallet has an active subscription for an agent.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"subscriberAddress": {
"type": "string",
"description": "Wallet address"
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"subscriberAddress",
"agentId"
]
}⚪actora_subscription_detail(chain, subscriptionId)
Full subscription detail including trial info, escrow status.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
},
"required": [
"subscriptionId"
]
}🟢actora_subscription_my_list(chain, userAddress)
List all subscription IDs for a wallet.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"userAddress": {
"type": "string",
"description": "Wallet address"
}
},
"required": [
"userAddress"
]
}🟡actora_subscription_subscribe(chain, planId, valueWei)
Subscribe to a plan. WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"planId": {
"type": "integer",
"description": "Plan ID"
},
"valueWei": {
"type": "string",
"description": "ETH in wei"
}
},
"required": [
"planId"
]
}🔴actora_subscription_cancel(chain, subscriptionId)
Cancel a subscription. WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
},
"required": [
"subscriptionId"
]
}⚪actora_subscription_release(chain, subscriptionId)
Deprecated: ERC8004SubscriptionManager settles payments on subscribe/renew, so there is no escrow to release.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
},
"required": [
"subscriptionId"
]
}🟢actora_subscription_fee(chain)
Get current platform fee in bps.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
}
}
}🟡actora_subscription_create_plan(chain, agentId, name, description, planType, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"name": {
"type": "string",
"description": "Plan name (required on-chain; defaults to \"Plan #<agentId>\")"
},
"description": {
"type": "string",
"description": "Plan description"
},
"planType": {
"type": "integer",
"description": "0=subscription (default), 1=usage-based, 2=hybrid"
},
"price": {
"type": "string",
"description": "Recurring price in wei/token units (required unless planType=1)"
},
"usagePrice": {
"type": "string",
"description": "Per-use price (required when planType is 1 or 2)"
},
"period": {
"type": "string",
"description": "\"day\" | \"week\" | \"month\" | \"quarter\" | \"year\""
},
"payToken": {
"type": "string",
"description": "ERC20 token address; omit for native ETH"
},
"maxUsage": {
"type": "string",
"description": "Max usage per billing period (0 = unlimited)"
},
"totalUsageLimit": {
"type": "string",
"description": "Total usage limit (0 = unlimited)"
}
},
"required": [
"agentId",
"period"
]
}🟢actora_central_agent_list(activeOnly, category, capabilities, page, pageSize)
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.
입력 스키마
{
"type": "object",
"properties": {
"activeOnly": {
"type": "boolean",
"description": "Only return is_active=true agents"
},
"category": {
"type": "string",
"description": "Category filter, e.g. \"finance\""
},
"capabilities": {
"type": "string",
"description": "Comma-separated capability filter, e.g. \"chat,trading\""
},
"page": {
"type": "integer",
"description": "Page number (default 1)"
},
"pageSize": {
"type": "integer",
"description": "Page size (default 50, max 100)"
}
}
}🟢actora_central_subscription_check(subscriber, agentId)
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.
입력 스키마
{
"type": "object",
"properties": {
"subscriber": {
"type": "string",
"description": "Wallet address (0x...)"
},
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
}
},
"required": [
"subscriber",
"agentId"
]
}🟡actora_central_agent_create(name, description, tags, capabilities, skills, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Agent name (required)"
},
"description": {
"type": "string",
"description": "Agent description"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capabilities, e.g. [\"chat\",\"trading\"]"
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill names"
},
"category": {
"type": "string",
"description": "Category, e.g. \"finance\""
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"name",
"access_token"
]
}🟡actora_central_agent_update(agentId, name, description, tags, capabilities, ...)
Update a centralized agent you own (PATCH semantics — only provided fields change). Requires access_token (registered-user JWT). WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
},
"name": {
"type": "string",
"description": "Agent name"
},
"description": {
"type": "string",
"description": "Agent description"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capabilities"
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill names"
},
"category": {
"type": "string",
"description": "Category"
},
"isActive": {
"type": "boolean",
"description": "List (true) or delist (false) the agent"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"agentId",
"access_token"
]
}⚪actora_central_subscription_subscribe(agentId, subscriber, period, priceWei, txHash, ...)
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 to verify and activate the subscription.
입력 스키마
{
"type": "object",
"properties": {
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
},
"subscriber": {
"type": "string",
"description": "Buyer wallet address (0x...)"
},
"period": {
"type": "string",
"description": "\"day\" | \"week\" | \"month\" | \"year\" (default \"month\")"
},
"priceWei": {
"type": "string",
"description": "Plan price in wei (overrides the default active plan price)"
},
"txHash": {
"type": "string",
"description": "x402 on-chain payment tx hash — include to verify and activate"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"agentId",
"subscriber",
"access_token"
]
}🟡actora_a2a_create_task(chain, targetAgentId, taskType, inputData)
Create an on-chain A2A task. WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"targetAgentId": {
"type": "integer",
"description": "Target agent ID"
},
"taskType": {
"type": "string",
"description": "e.g. audit, analyze"
},
"inputData": {
"type": "string",
"description": "JSON input"
}
},
"required": [
"targetAgentId",
"taskType",
"inputData"
]
}🟢actora_a2a_get_task(chain, taskId)
Get A2A task details.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"taskId": {
"type": "integer",
"description": "Task ID"
}
},
"required": [
"taskId"
]
}🟡actora_a2a_complete_task(chain, taskId, outputData)
Complete a task on-chain. WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"taskId": {
"type": "integer",
"description": "Task ID"
},
"outputData": {
"type": "string",
"description": "JSON output"
}
},
"required": [
"taskId",
"outputData"
]
}🟢actora_a2a_my_tasks(chain, userAddress)
Get all task IDs for a wallet.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"userAddress": {
"type": "string",
"description": "Wallet address"
}
},
"required": [
"userAddress"
]
}🟢actora_a2a_agent_card(chain, agentId)
Get agent A2A card: name, capabilities, supported tasks.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}🟡actora_reputation_rate(chain, agentId, rating, comment)
Rate an agent (1-5). WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"rating": {
"type": "integer",
"description": "1-5"
},
"comment": {
"type": "string",
"description": "Review"
}
},
"required": [
"agentId",
"rating"
]
}🟢actora_reputation_get(chain, agentId)
Average rating and review count.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}⚪actora_reputation_reviews(chain, agentId)
All reviews with reviewer, rating, comment, timestamp.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}🟢actora_config_get(chain, agentId, configKey)
Read an agent spec/config value by key from the platform DB (not the on-chain ConfigurationRegistry).
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"configKey": {
"type": "string",
"description": "Config key (name | description | category | tags | capabilities | skills | card)"
}
},
"required": [
"agentId",
"configKey"
]
}🟢actora_config_list(chain, agentId)
List all agent spec/config values for an agent from the platform DB.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}🟡actora_config_set(chain, agentId, key, value, dataType)
Config writes are owner-signed on the platform API (PATCH /api/v1/agents/:chain/:id); returns instructions. WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"key": {
"type": "string"
},
"value": {
"type": "string"
},
"dataType": {
"type": "string",
"enum": [
"string",
"number",
"boolean",
"json"
]
}
},
"required": [
"agentId",
"key",
"value"
]
}🟢actora_endpoint_list(chain, agentId)
All registered endpoints from the platform DB (includes pending/failed).
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}⚪actora_endpoint_active(chain, agentId)
Only live endpoints from the platform DB.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}⚪actora_endpoint_best_mcp(chain, agentId)
Best available MCP endpoint URL from the platform DB.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported.",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
},
"required": [
"agentId"
]
}⚪actora_endpoint_status(access_token)
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).
입력 스키마
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"access_token"
]
}🟢actora_gateway_tenant(access_token, accessToken)
Get tenant profile, plan, quota. Requires access_token (registered-user JWT); `Authorization: Bearer` is injected automatically.
입력 스키마
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT token (registered-user auth)"
},
"accessToken": {
"type": "string",
"description": "Deprecated alias of access_token"
}
}
}⚪actora_gateway_health
Gateway health + chain contract addresses (BSC / Ethereum / Base).
입력 스키마
{
"type": "object",
"properties": {}
}⚪actora_gateway_chat(message, agent_id, prompt, history, tenant_key_id, ...)
Single-turn conversation with an agent (SSE stream collected into a reply). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "User message"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt (bypasses agent lookup)"
},
"history": {
"type": "array",
"description": "Optional conversation history [{role, content}]"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"message"
]
}🟡actora_gateway_create_session(agent_id, title, access_token)
Create a conversation session (dialog container; idempotent). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"description": "Agent ID"
},
"title": {
"type": "string",
"description": "Optional session title"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
}
}🟡actora_gateway_create_task(session_id, message, agent_id, prompt, tenant_key_id, ...)
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).
입력 스키마
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID (from actora_gateway_create_session)"
},
"message": {
"type": "string",
"description": "Task instruction"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id",
"message"
]
}🟢actora_gateway_get_task(task_id, access_token)
Get task detail by id (status, result, error). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_gateway_list_tasks(session_id, access_token)
List all tasks of a session. Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id"
]
}🔴actora_gateway_cancel_task(task_id, access_token)
Cancel a task (queued → cancelled; running → aborted; terminal states are idempotent). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_listing_get(chain, agentId)
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.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain or \"central\" for off-chain agents",
"enum": [
"bsc",
"ethereum",
"base",
"central"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID (negative for centralized agents)"
}
},
"required": [
"chain",
"agentId"
]
}🟡actora_listing_set(chain, agentId, endpoint, protocol, visibility, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain or \"central\"",
"enum": [
"bsc",
"ethereum",
"base",
"central"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID (negative for centralized agents)"
},
"endpoint": {
"type": "string",
"description": "Agent endpoint URL (a2a or mcp). Omit/empty = platform-hosted (central only)"
},
"protocol": {
"type": "string",
"description": "Endpoint protocol (default a2a)",
"enum": [
"a2a",
"mcp"
]
},
"visibility": {
"type": "string",
"description": "Marketplace visibility",
"enum": [
"public",
"unlisted"
]
},
"pricingType": {
"type": "string",
"description": "Pricing model",
"enum": [
"subscription",
"per_call",
"free"
]
},
"priceUsdCents": {
"type": "integer",
"description": "USD cents (required when pricingType=per_call)"
},
"paymentLinkUrl": {
"type": "string",
"description": "Publisher-hosted fiat checkout link (platform does not collect)"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 10 discovery tags"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"chain",
"agentId",
"access_token"
]
}🟡actora_listing_price(chain, agentId, pricingType, priceUsdCents, access_token)
Update pricing for an existing listing (subscription / per_call / free + USD cents). Requires access_token (owner JWT). WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain or \"central\"",
"enum": [
"bsc",
"ethereum",
"base",
"central"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"pricingType": {
"type": "string",
"description": "Pricing model",
"enum": [
"subscription",
"per_call",
"free"
]
},
"priceUsdCents": {
"type": "integer",
"description": "USD cents (required when pricingType=per_call)"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"chain",
"agentId",
"access_token"
]
}🔴actora_listing_delist(chain, agentId, access_token)
Remove a listing (delist) and mark its endpoints as delisted. Requires access_token (owner JWT). WRITE operation.
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain or \"central\"",
"enum": [
"bsc",
"ethereum",
"base",
"central"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"chain",
"agentId",
"access_token"
]
}⚪actora_endpoint_probe(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).
입력 스키마
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Chain or \"central\"",
"enum": [
"bsc",
"ethereum",
"base",
"central"
]
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"chain",
"agentId",
"access_token"
]
}🟢actora_payload_key_list(agentId, chain, 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.
입력 스키마
{
"type": "object",
"properties": {
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"chain": {
"type": "string",
"description": "Optional chain filter",
"enum": [
"bsc",
"ethereum",
"base"
]
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
},
"required": [
"agentId",
"access_token"
]
}🟢actora_tenant_plans(access_token)
List platform plans for B-side tenants (Free / Pro / Enterprise: quota, rate limit, concurrency, BYOK). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}⚪actora_tenant_usage(days, access_token)
Token/tool-call usage summary and daily timeline for the current tenant. Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback window in days (1..365, default 30)"
},
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}커뮤니티
증거