Actora developer tools: ERC-8004 identity, subscriptions, listings, A2A, reputation.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get agent A2A card: name, capabilities, supported tasks.
Agent ID
Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http actora-platform https://actora.codes/mcp/platform
Get agent A2A card: name, capabilities, supported tasks.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Complete a task on-chain. WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| taskId* | integer | Task ID |
| outputData* | string | JSON output |
{
"type": "object",
"required": [
"taskId",
"outputData"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"taskId": {
"type": "integer",
"description": "Task ID"
},
"outputData": {
"type": "string",
"description": "JSON output"
}
}
}Create an on-chain A2A task. WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| taskType* | string | e.g. audit, analyze |
| inputData* | string | JSON input |
| targetAgentId* | integer | Target agent ID |
{
"type": "object",
"required": [
"targetAgentId",
"taskType",
"inputData"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"taskType": {
"type": "string",
"description": "e.g. audit, analyze"
},
"inputData": {
"type": "string",
"description": "JSON input"
},
"targetAgentId": {
"type": "integer",
"description": "Target agent ID"
}
}
}Get A2A task details.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| taskId* | integer | Task ID |
{
"type": "object",
"required": [
"taskId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"taskId": {
"type": "integer",
"description": "Task ID"
}
}
}Get all task IDs for a wallet.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| userAddress* | string | Wallet address |
{
"type": "object",
"required": [
"userAddress"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"userAddress": {
"type": "string",
"description": "Wallet address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name* | string | Agent name (required) |
| tags | array | Tags |
| skills | array | Skill names |
| category | string | Category, e.g. "finance" |
| description | string | Agent description |
| access_token* | string | Gateway JWT — registered-user auth (required) |
| capabilities | array | Capabilities, e.g. ["chat","trading"] |
{
"type": "object",
"required": [
"name",
"access_token"
],
"properties": {
"name": {
"type": "string",
"description": "Agent name (required)"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags"
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill names"
},
"category": {
"type": "string",
"description": "Category, e.g. \"finance\""
},
"description": {
"type": "string",
"description": "Agent description"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capabilities, e.g. [\"chat\",\"trading\"]"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page number (default 1) |
| category | string | Category filter, e.g. "finance" |
| pageSize | integer | Page size (default 50, max 100) |
| activeOnly | boolean | Only return is_active=true agents |
| capabilities | string | Comma-separated capability filter, e.g. "chat,trading" |
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"description": "Page number (default 1)"
},
"category": {
"type": "string",
"description": "Category filter, e.g. \"finance\""
},
"pageSize": {
"type": "integer",
"description": "Page size (default 50, max 100)"
},
"activeOnly": {
"type": "boolean",
"description": "Only return is_active=true agents"
},
"capabilities": {
"type": "string",
"description": "Comma-separated capability filter, e.g. \"chat,trading\""
}
}
}Update a centralized agent you own (PATCH semantics — only provided fields change). Requires access_token (registered-user JWT). WRITE operation.
| Argument | Type | Description |
|---|---|---|
| name | string | Agent name |
| tags | array | Tags |
| skills | array | Skill names |
| agentId* | integer | Centralized agent ID (negative) |
| category | string | Category |
| isActive | boolean | List (true) or delist (false) the agent |
| description | string | Agent description |
| access_token* | string | Gateway JWT — registered-user auth (required) |
| capabilities | array | Capabilities |
{
"type": "object",
"required": [
"agentId",
"access_token"
],
"properties": {
"name": {
"type": "string",
"description": "Agent name"
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags"
},
"skills": {
"type": "array",
"items": {
"type": "string"
},
"description": "Skill names"
},
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
},
"category": {
"type": "string",
"description": "Category"
},
"isActive": {
"type": "boolean",
"description": "List (true) or delist (false) the agent"
},
"description": {
"type": "string",
"description": "Agent description"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
},
"description": "Capabilities"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| agentId* | integer | Centralized agent ID (negative) |
| subscriber* | string | Wallet address (0x...) |
{
"type": "object",
"required": [
"subscriber",
"agentId"
],
"properties": {
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
},
"subscriber": {
"type": "string",
"description": "Wallet address (0x...)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| period | string | "day" | "week" | "month" | "year" (default "month") |
| txHash | string | x402 on-chain payment tx hash — include to verify and activate |
| agentId* | integer | Centralized agent ID (negative) |
| priceWei | string | Plan price in wei (overrides the default active plan price) |
| subscriber* | string | Buyer wallet address (0x...) |
| access_token* | string | Gateway JWT — registered-user auth (required) |
{
"type": "object",
"required": [
"agentId",
"subscriber",
"access_token"
],
"properties": {
"period": {
"type": "string",
"description": "\"day\" | \"week\" | \"month\" | \"year\" (default \"month\")"
},
"txHash": {
"type": "string",
"description": "x402 on-chain payment tx hash — include to verify and activate"
},
"agentId": {
"type": "integer",
"description": "Centralized agent ID (negative)"
},
"priceWei": {
"type": "string",
"description": "Plan price in wei (overrides the default active plan price)"
},
"subscriber": {
"type": "string",
"description": "Buyer wallet address (0x...)"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
}
}Read an agent spec/config value by key from the platform DB (not the on-chain ConfigurationRegistry).
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
| configKey* | string | Config key (name | description | category | tags | capabilities | skills | card) |
{
"type": "object",
"required": [
"agentId",
"configKey"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"configKey": {
"type": "string",
"description": "Config key (name | description | category | tags | capabilities | skills | card)"
}
}
}List all agent spec/config values for an agent from the platform DB.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Config writes are owner-signed on the platform API (PATCH /api/v1/agents/:chain/:id); returns instructions. WRITE operation.
| Argument | Type | Description |
|---|---|---|
| key* | string | |
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| value* | string | |
| agentId* | integer | Agent ID |
| dataType | string |
{
"type": "object",
"required": [
"agentId",
"key",
"value"
],
"properties": {
"key": {
"type": "string"
},
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"value": {
"type": "string"
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"dataType": {
"enum": [
"string",
"number",
"boolean",
"json"
],
"type": "string"
}
}
}Only live endpoints from the platform DB.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Best available MCP endpoint URL from the platform DB.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}All registered endpoints from the platform DB (includes pending/failed).
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Re-probe the primary endpoint of a listed agent (a2a or mcp) and return the liveness result. Requires access_token (owner JWT).
| Argument | Type | Description |
|---|---|---|
| chain* | string | Chain or "central" |
| agentId* | integer | Agent ID |
| access_token* | string | Gateway JWT — owner auth (required) |
{
"type": "object",
"required": [
"chain",
"agentId",
"access_token"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base",
"central"
],
"type": "string",
"description": "Chain or \"central\""
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| access_token* | string | Gateway JWT — owner auth (required) |
{
"type": "object",
"required": [
"access_token"
],
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
}
}Gateway health + chain contract addresses (BSC / Ethereum / Base).
No arguments.
{
"type": "object",
"properties": {}
}Check whether an agent ID exists on-chain.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Get agent details — tokenURI, metadata, existence.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent numeric ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent numeric ID"
}
}
}List all Agent IDs owned by a wallet address on BSC, Ethereum or Base.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| ownerAddress* | string | Ethereum wallet address (0x...) |
{
"type": "object",
"required": [
"ownerAddress"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"ownerAddress": {
"type": "string",
"description": "Ethereum wallet address (0x...)"
}
}
}List all agents with structured metadata (name, capabilities, skills, isActive). Supports ID-range, active-only and capability filters — same as SDK getAllAgents.
| Argument | Type | Description |
|---|---|---|
| toId | integer | End Agent ID (default: last agent) |
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| fromId | integer | Start Agent ID (default 1) |
| activeOnly | boolean | Only return isActive=true agents |
| capabilities | string | Comma-separated capability filter, e.g. "trading,analysis" |
{
"type": "object",
"properties": {
"toId": {
"type": "integer",
"description": "End Agent ID (default: last agent)"
},
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"fromId": {
"type": "integer",
"description": "Start Agent ID (default 1)"
},
"activeOnly": {
"type": "boolean",
"description": "Only return isActive=true agents"
},
"capabilities": {
"type": "string",
"description": "Comma-separated capability filter, e.g. \"trading,analysis\""
}
}
}Get structured metadata for one agent: name, description, capabilities, skills, isActive, createdAt.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent numeric ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent numeric ID"
}
}
}Register a new Agent on-chain. WRITE operation — returns tx payload.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| tokenURI* | string | IPFS URI (ipfs://...) |
| eciesEncryptedKey* | string | Hex ECIES-encrypted AES key |
| encryptedPayloadCid* | string | IPFS CID of encrypted payload |
{
"type": "object",
"required": [
"tokenURI",
"encryptedPayloadCid",
"eciesEncryptedKey"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"tokenURI": {
"type": "string",
"description": "IPFS URI (ipfs://...)"
},
"eciesEncryptedKey": {
"type": "string",
"description": "Hex ECIES-encrypted AES key"
},
"encryptedPayloadCid": {
"type": "string",
"description": "IPFS CID of encrypted payload"
}
}
}Total number of agents registered.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
{
"type": "object",
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
}
}
}Remove a listing (delist) and mark its endpoints as delisted. Requires access_token (owner JWT). WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain* | string | Chain or "central" |
| agentId* | integer | Agent ID |
| access_token* | string | Gateway JWT — owner auth (required) |
{
"type": "object",
"required": [
"chain",
"agentId",
"access_token"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base",
"central"
],
"type": "string",
"description": "Chain or \"central\""
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| chain* | string | Chain or "central" for off-chain agents |
| agentId* | integer | Agent ID (negative for centralized agents) |
{
"type": "object",
"required": [
"chain",
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base",
"central"
],
"type": "string",
"description": "Chain or \"central\" for off-chain agents"
},
"agentId": {
"type": "integer",
"description": "Agent ID (negative for centralized agents)"
}
}
}Update pricing for an existing listing (subscription / per_call / free + USD cents). Requires access_token (owner JWT). WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain* | string | Chain or "central" |
| agentId* | integer | Agent ID |
| pricingType | string | Pricing model |
| access_token* | string | Gateway JWT — owner auth (required) |
| priceUsdCents | integer | USD cents (required when pricingType=per_call) |
{
"type": "object",
"required": [
"chain",
"agentId",
"access_token"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base",
"central"
],
"type": "string",
"description": "Chain or \"central\""
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"pricingType": {
"enum": [
"subscription",
"per_call",
"free"
],
"type": "string",
"description": "Pricing model"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
},
"priceUsdCents": {
"type": "integer",
"description": "USD cents (required when pricingType=per_call)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| tags | array | Up to 10 discovery tags |
| chain* | string | Chain or "central" |
| agentId* | integer | Agent ID (negative for centralized agents) |
| endpoint | string | Agent endpoint URL (a2a or mcp). Omit/empty = platform-hosted (central only) |
| protocol | string | Endpoint protocol (default a2a) |
| visibility | string | Marketplace visibility |
| pricingType | string | Pricing model |
| access_token* | string | Gateway JWT — owner auth (required) |
| priceUsdCents | integer | USD cents (required when pricingType=per_call) |
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.
| Argument | Type | Description |
|---|---|---|
| chain | string | Optional chain filter |
| agentId* | integer | Agent ID |
| access_token* | string | Gateway JWT — owner auth (required) |
{
"type": "object",
"required": [
"agentId",
"access_token"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Optional chain filter"
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
}
}
}Average rating and review count.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Rate an agent (1-5). WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| rating* | integer | 1-5 |
| agentId* | integer | Agent ID |
| comment | string | Review |
{
"type": "object",
"required": [
"agentId",
"rating"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"rating": {
"type": "integer",
"description": "1-5"
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"comment": {
"type": "string",
"description": "Review"
}
}
}All reviews with reviewer, rating, comment, timestamp.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
{
"type": "object",
"required": [
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
}
}
}Cancel a subscription. WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| subscriptionId* | integer | Subscription ID |
{
"type": "object",
"required": [
"subscriptionId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
}
}Check if a wallet has an active subscription for an agent.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| agentId* | integer | Agent ID |
| subscriberAddress* | string | Wallet address |
{
"type": "object",
"required": [
"subscriberAddress",
"agentId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"subscriberAddress": {
"type": "string",
"description": "Wallet address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| name | string | Plan name (required on-chain; defaults to "Plan #<agentId>") |
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| price | string | Recurring price in wei/token units (required unless planType=1) |
| period* | string | "day" | "week" | "month" | "quarter" | "year" |
| agentId* | integer | Agent ID |
| maxUsage | string | Max usage per billing period (0 = unlimited) |
| payToken | string | ERC20 token address; omit for native ETH |
| planType | integer | 0=subscription (default), 1=usage-based, 2=hybrid |
| usagePrice | string | Per-use price (required when planType is 1 or 2) |
Full subscription detail including trial info, escrow status.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| subscriptionId* | integer | Subscription ID |
{
"type": "object",
"required": [
"subscriptionId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
}
}Get current platform fee in bps.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
{
"type": "object",
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
}
}
}List all subscription IDs for a wallet.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| userAddress* | string | Wallet address |
{
"type": "object",
"required": [
"userAddress"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"userAddress": {
"type": "string",
"description": "Wallet address"
}
}
}Get plan details: price, period, pay token, trial days.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| planId* | integer | Plan ID |
{
"type": "object",
"required": [
"planId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"planId": {
"type": "integer",
"description": "Plan ID"
}
}
}Deprecated: ERC8004SubscriptionManager settles payments on subscribe/renew, so there is no escrow to release.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| subscriptionId* | integer | Subscription ID |
{
"type": "object",
"required": [
"subscriptionId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"subscriptionId": {
"type": "integer",
"description": "Subscription ID"
}
}
}Subscribe to a plan. WRITE operation.
| Argument | Type | Description |
|---|---|---|
| chain | string | Chain: "bsc" (default) | "ethereum" | "base". Sepolia testnet is not supported. |
| planId* | integer | Plan ID |
| valueWei | string | ETH in wei |
{
"type": "object",
"required": [
"planId"
],
"properties": {
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"planId": {
"type": "integer",
"description": "Plan ID"
},
"valueWei": {
"type": "string",
"description": "ETH in wei"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 4, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
| paymentLinkUrl | string | Publisher-hosted fiat checkout link (platform does not collect) |
{
"type": "object",
"required": [
"chain",
"agentId",
"access_token"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 10 discovery tags"
},
"chain": {
"enum": [
"bsc",
"ethereum",
"base",
"central"
],
"type": "string",
"description": "Chain or \"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": {
"enum": [
"a2a",
"mcp"
],
"type": "string",
"description": "Endpoint protocol (default a2a)"
},
"visibility": {
"enum": [
"public",
"unlisted"
],
"type": "string",
"description": "Marketplace visibility"
},
"pricingType": {
"enum": [
"subscription",
"per_call",
"free"
],
"type": "string",
"description": "Pricing model"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — owner auth (required)"
},
"priceUsdCents": {
"type": "integer",
"description": "USD cents (required when pricingType=per_call)"
},
"paymentLinkUrl": {
"type": "string",
"description": "Publisher-hosted fiat checkout link (platform does not collect)"
}
}
}| description | string | Plan description |
| totalUsageLimit | string | Total usage limit (0 = unlimited) |
{
"type": "object",
"required": [
"agentId",
"period"
],
"properties": {
"name": {
"type": "string",
"description": "Plan name (required on-chain; defaults to \"Plan #<agentId>\")"
},
"chain": {
"enum": [
"bsc",
"ethereum",
"base"
],
"type": "string",
"description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
},
"price": {
"type": "string",
"description": "Recurring price in wei/token units (required unless planType=1)"
},
"period": {
"type": "string",
"description": "\"day\" | \"week\" | \"month\" | \"quarter\" | \"year\""
},
"agentId": {
"type": "integer",
"description": "Agent ID"
},
"maxUsage": {
"type": "string",
"description": "Max usage per billing period (0 = unlimited)"
},
"payToken": {
"type": "string",
"description": "ERC20 token address; omit for native ETH"
},
"planType": {
"type": "integer",
"description": "0=subscription (default), 1=usage-based, 2=hybrid"
},
"usagePrice": {
"type": "string",
"description": "Per-use price (required when planType is 1 or 2)"
},
"description": {
"type": "string",
"description": "Plan description"
},
"totalUsageLimit": {
"type": "string",
"description": "Total usage limit (0 = unlimited)"
}
}
}