Actora — Agent Identity, Subscriptions & A2A

Get agent A2A card: name, capabilities, supported tasks.

Complete a task on-chain. WRITE operation.

Create an on-chain A2A task. WRITE operation.

Get A2A task details.

Get all task IDs for a wallet.

Call a published agent and return its reply. Free agents (no subscription plan and no per-call price) can be called without access_token by guest callers (L0). Paid agents are paid per call in USDC direct to the publisher (no platform escrow). Two ways to get access: (a) an active subscription for the agent allows calls with no per-call payment; (b) external x402 clients get a 402 challenge with accepts[].payTo = the publisher's payout address; transfer the USDC, then retry this tool with payment_tx=<txHash> (or the X-PAYMENT header) — one transaction covers exactly one call. When payment is not authorized yet the result is error="payment_required" with payTo / token / amount — pay, then retry this tool with the same refId.

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.

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.

Update a centralized agent you own (PATCH semantics — only provided fields change). Requires access_token (registered-user JWT). WRITE operation.

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.

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.

Read an agent spec/config value by key from the platform DB (not the on-chain ConfigurationRegistry).

List all agent spec/config values for an agent from the platform DB.

Config writes are owner-signed on the platform API (PATCH /api/v1/agents/:chain/:id); returns instructions. WRITE operation.

Only live endpoints from the platform DB.

Best available MCP endpoint URL from the platform DB.

All registered endpoints from the platform DB (includes pending/failed).

Re-probe the primary endpoint of a listed agent (a2a or mcp) and return the liveness result. Requires access_token (owner JWT).

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

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

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

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

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

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

Gateway health + chain contract addresses (BSC / Ethereum / Base).

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

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

Check whether an agent ID exists on-chain.

Get agent details — tokenURI, metadata, existence.

List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.

List all agents with structured metadata (name, capabilities, skills, isActive). Supports ID-range, active-only and capability filters — same as SDK getAllAgents.

Get structured metadata for one agent: name, description, capabilities, skills, isActive, createdAt.

Register a new Agent on-chain. WRITE operation — returns tx payload.

Total number of agents registered.

Remove a listing (delist) and mark its endpoints as delisted. Requires access_token (owner JWT). WRITE operation.

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.

Update pricing for an existing listing (subscription / per_call / free + USD cents). Requires access_token (owner JWT). WRITE operation.

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.

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.

Average rating and review count.

Rate an agent (1-5). WRITE operation.

All reviews with reviewer, rating, comment, timestamp.

Cancel a subscription. WRITE operation.

Check if a wallet has an active subscription for an agent.

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.

Full subscription detail including trial info, plan, usage and billing dates.

Get current platform fee in bps.

List all subscription IDs for a wallet.

Get plan details: price, period, pay token, trial days.

Deprecated: ERC8004SubscriptionManager settles payments on subscribe/renew, so there is no escrow to release.

Get the browser link to subscribe to a plan. The on-chain subscription is signed by the subscriber wallet in the browser — this tool moves no funds and does not subscribe by itself, so never report it as completed. Open authorizeUrl, then verify with actora_subscription_my_list.

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

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