Servers Playground How we check Add a server Log in

Actora — Agent Identity, Subscriptions & A2A

Working Security A

io.github.sftgroup/actorav0.2.0 GitHub verified

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

Crypto & Web3 AI & Agents

Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-04T12:05:51.575237Z",
      "publishedAt": "2026-11-04T12:05:51.575237Z",
      "statusChangedAt": "2026-11-04T12:05:51.575237Z"
    }
  },
  "server": {
    "name": "io.github.sftgroup/actora",
    "icons": [
      {
        "src": "https://actora.codes/icon-512.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Actora — Agent Identity, Subscriptions & A2A",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://actora.codes/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.2.0",
    "repository": {
      "url": "https://github.com/sftgroup/Agentx",
      "source": "github"
    },
    "websiteUrl": "https://actora.codes",
    "description": "ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 52 tools."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://actora.codes/mcp

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.

actora_a2a_agent_card

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

agentIdinteger, required

Agent ID

chainstring

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.

I understand, run it anyway

Actora — Agent Identity, Subscriptions & A2A MCP server | mcptry

Actora — Agent Identity, Subscriptions & A2A

Working Security A

io.github.sftgroup/actorav0.2.0 GitHub verified

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

Crypto & Web3 AI & Agents

Watch Watch Source Website

Registry entry

Open in the registry

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-11-04T12:05:51.575237Z",
      "publishedAt": "2026-11-04T12:05:51.575237Z",
      "statusChangedAt": "2026-11-04T12:05:51.575237Z"
    }
  },
  "server": {
    "name": "io.github.sftgroup/actora",
    "icons": [
      {
        "src": "https://actora.codes/icon-512.png",
        "sizes": [
          "512x512"
        ],
        "mimeType": "image/png"
      }
    ],
    "title": "Actora — Agent Identity, Subscriptions & A2A",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "remotes": [
      {
        "url": "https://actora.codes/mcp",
        "type": "streamable-http"
      }
    ],
    "version": "0.2.0",
    "repository": {
      "url": "https://github.com/sftgroup/Agentx",
      "source": "github"
    },
    "websiteUrl": "https://actora.codes",
    "description": "ERC-8004 agent identity, on-chain subscriptions, reputation, A2A tasks and chat over 52 tools."
  }
}

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://actora.codes/mcp

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.

actora_a2a_agent_card

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

agentIdinteger, required

Agent ID

chainstring

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.

I understand, run it anyway

Tools (52)

actora_a2a_agent_card

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_a2a_complete_task

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_a2a_create_task

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_a2a_get_task

Get A2A task details.

Argument	Type	Description
chain	string	Chain: "bsc" (default) \| "ethereum" \| "base". Sepolia testnet is not supported.
taskId*	integer	Task ID

Input schema (JSON)

{
  "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"
    }
  }
}

actora_a2a_my_tasks

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

Input schema (JSON)

{
  "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"
    }
  }
}

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.

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"]

Input schema (JSON)

{
  "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\"]"
    }
  }
}

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.

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"

Input schema (JSON)

{
  "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\""
    }
  }
}

actora_central_agent_update

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

Input schema (JSON)

{
  "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"
    }
  }
}

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.

Argument	Type	Description
agentId*	integer	Centralized agent ID (negative)
subscriber*	string	Wallet address (0x...)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "subscriber",
    "agentId"
  ],
  "properties": {
    "agentId": {
      "type": "integer",
      "description": "Centralized agent ID (negative)"
    },
    "subscriber": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  }
}

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

Input schema (JSON)

{
  "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)"
    }
  }
}

actora_config_get

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)

Input schema (JSON)

{
  "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)"
    }
  }
}

actora_config_list

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_config_set

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_endpoint_active

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_endpoint_best_mcp

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_endpoint_list

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

Input schema (JSON)

{
  "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"
    }
  }
}

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

Argument	Type	Description
chain*	string	Chain or "central"
agentId*	integer	Agent ID
access_token*	string	Gateway JWT — owner auth (required)

Input schema (JSON)

{
  "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)"
    }
  }
}

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

Argument	Type	Description
access_token*	string	Gateway JWT — owner auth (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "access_token"
  ],
  "properties": {
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — owner auth (required)"
    }
  }
}

actora_gateway_cancel_task

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

Argument	Type	Description
task_id*	string	Task ID
access_token	string	Gateway JWT — registered-user auth (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task ID"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    }
  }
}

actora_gateway_chat

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

Argument	Type	Description
prompt	string	Inline mode: caller-supplied system prompt (bypasses agent lookup)
history	array	Optional conversation history [{role, content}]
message*	string	User message
agent_id	integer	Agent ID (omit when using inline prompt)
access_token	string	Gateway JWT — registered-user auth (required)
tenant_key_id	string	BYOK: id of a stored tenant-owned API key

Input schema (JSON)

{
  "type": "object",
  "required": [
    "message"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Inline mode: caller-supplied system prompt (bypasses agent lookup)"
    },
    "history": {
      "type": "array",
      "description": "Optional conversation history [{role, content}]"
    },
    "message": {
      "type": "string",
      "description": "User message"
    },
    "agent_id": {
      "type": "integer",
      "description": "Agent ID (omit when using inline prompt)"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    },
    "tenant_key_id": {
      "type": "string",
      "description": "BYOK: id of a stored tenant-owned API key"
    }
  }
}

actora_gateway_create_session

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

Argument	Type	Description
title	string	Optional session title
agent_id	integer	Agent ID
access_token	string	Gateway JWT — registered-user auth (required)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Optional session title"
    },
    "agent_id": {
      "type": "integer",
      "description": "Agent ID"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    }
  }
}

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

Argument	Type	Description
prompt	string	Inline mode: caller-supplied system prompt
message*	string	Task instruction
agent_id	integer	Agent ID (omit when using inline prompt)
session_id*	string	Session ID (from actora_gateway_create_session)
access_token	string	Gateway JWT — registered-user auth (required)
tenant_key_id	string	BYOK: id of a stored tenant-owned API key

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id",
    "message"
  ],
  "properties": {
    "prompt": {
      "type": "string",
      "description": "Inline mode: caller-supplied system prompt"
    },
    "message": {
      "type": "string",
      "description": "Task instruction"
    },
    "agent_id": {
      "type": "integer",
      "description": "Agent ID (omit when using inline prompt)"
    },
    "session_id": {
      "type": "string",
      "description": "Session ID (from actora_gateway_create_session)"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    },
    "tenant_key_id": {
      "type": "string",
      "description": "BYOK: id of a stored tenant-owned API key"
    }
  }
}

actora_gateway_get_task

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

Argument	Type	Description
task_id*	string	Task ID
access_token	string	Gateway JWT — registered-user auth (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "task_id"
  ],
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task ID"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    }
  }
}

actora_gateway_health

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

actora_gateway_list_tasks

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

Argument	Type	Description
session_id*	string	Session ID
access_token	string	Gateway JWT — registered-user auth (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "description": "Session ID"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    }
  }
}

actora_gateway_tenant

Get tenant profile, plan, quota.

Argument	Type	Description
accessToken*	string	Gateway JWT token

Input schema (JSON)

{
  "type": "object",
  "required": [
    "accessToken"
  ],
  "properties": {
    "accessToken": {
      "type": "string",
      "description": "Gateway JWT token"
    }
  }
}

actora_identity_exists

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_identity_get

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_identity_list

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

Input schema (JSON)

{
  "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...)"
    }
  }
}

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.

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"

Input schema (JSON)

{
  "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\""
    }
  }
}

actora_identity_metadata

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_identity_register

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_identity_total_count

Total number of agents registered.

Argument	Type	Description
chain	string	Chain: "bsc" (default) \| "ethereum" \| "base". Sepolia testnet is not supported.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "chain": {
      "enum": [
        "bsc",
        "ethereum",
        "base"
      ],
      "type": "string",
      "description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
    }
  }
}

actora_listing_delist

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)

Input schema (JSON)

{
  "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)"
    }
  }
}

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.

Argument	Type	Description
chain*	string	Chain or "central" for off-chain agents
agentId*	integer	Agent ID (negative for centralized agents)

Input schema (JSON)

{
  "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)"
    }
  }
}

actora_listing_price

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)

Input schema (JSON)

{
  "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)"
    }
  }
}

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.

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)

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.

Argument	Type	Description
chain	string	Optional chain filter
agentId*	integer	Agent ID
access_token*	string	Gateway JWT — owner auth (required)

Input schema (JSON)

{
  "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)"
    }
  }
}

actora_reputation_get

Average rating and review count.

Argument	Type	Description
chain	string	Chain: "bsc" (default) \| "ethereum" \| "base". Sepolia testnet is not supported.
agentId*	integer	Agent ID

Input schema (JSON)

{
  "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"
    }
  }
}

actora_reputation_rate

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_reputation_reviews

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_cancel

Cancel a subscription. WRITE operation.

Argument	Type	Description
chain	string	Chain: "bsc" (default) \| "ethereum" \| "base". Sepolia testnet is not supported.
subscriptionId*	integer	Subscription ID

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_check

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

Input schema (JSON)

{
  "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"
    }
  }
}

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.

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)

actora_subscription_detail

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_fee

Get current platform fee in bps.

Argument	Type	Description
chain	string	Chain: "bsc" (default) \| "ethereum" \| "base". Sepolia testnet is not supported.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "chain": {
      "enum": [
        "bsc",
        "ethereum",
        "base"
      ],
      "type": "string",
      "description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
    }
  }
}

actora_subscription_my_list

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_plans

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_release

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_subscription_subscribe

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

Input schema (JSON)

{
  "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"
    }
  }
}

actora_tenant_plans

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

Argument	Type	Description
access_token*	string	Gateway JWT (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "access_token"
  ],
  "properties": {
    "access_token": {
      "type": "string",
      "description": "Gateway JWT (required)"
    }
  }
}

actora_tenant_usage

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

Argument	Type	Description
days	integer	Lookback window in days (1..365, default 30)
access_token*	string	Gateway JWT (required)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "access_token"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "description": "Lookback window in days (1..365, default 30)"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT (required)"
    }
  }
}

Actora — Agent Identity, Subscriptions & A2A

Registry entry

Try it

actora_a2a_agent_card

Actora — Agent Identity, Subscriptions & A2A

Registry entry

Try it

actora_a2a_agent_card

Install

Tools (52)

Security checkA97/100