Koskamo

Actora Platform MCP

Actora Platform MCP provides 52 tools for interacting with the Actora Gateway, enabling agents to read on-chain identity data, manage subscription plans, publish and subscribe to centralized agents, handle A2A communication, and manage chat sessions and tasks via JSON-RPC 2.0.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Actora Platform MCP logo, by ActoraCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by Actora
MCP endpoint (Streamable HTTP)
https://actora.codes/mcp/platform
Vendor documentation

What its tools do

44 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

44 of 44 have a description · 44 of 44 declare behavior hints · 42 of 43 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Read on-chain agent identity and metadata
  • Publish and manage centralized agent listings
  • Manage subscription plans and payments
  • Create and manage chat sessions and tasks

Source and maintenance

Community listingRegistry 0.2.1
Maintenance checked

Protocol and capabilities

Server
actora-platform 0.2.0
MCP protocol negotiated in check
2024-11-05
Tools
44 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Tools

44 advertised

actora_identity_list — List Agents by Owner
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_identity_list input schema
{
  "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 annotations
{
  "title": "List Agents by Owner",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_get — Get Agent
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get agent details — tokenURI, metadata, existence.

actora_identity_get input schema
{
  "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_get annotations
{
  "title": "Get Agent",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_list_all — List All Agents
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_identity_list_all input schema
{
  "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_list_all annotations
{
  "title": "List All Agents",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_metadata — Get Agent Metadata
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_identity_metadata input schema
{
  "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_metadata annotations
{
  "title": "Get Agent Metadata",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_exists — Check Agent Exists
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check whether an agent ID exists on-chain.

actora_identity_exists input schema
{
  "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_exists annotations
{
  "title": "Check Agent Exists",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_total_count — Count Registered Agents
Advertised by the server during the last successful anonymous check.
Advertised read-only

Total number of agents registered.

actora_identity_total_count input schema
{
  "type": "object",
  "properties": {
    "chain": {
      "enum": [
        "bsc",
        "ethereum",
        "base"
      ],
      "type": "string",
      "description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
    }
  }
}
actora_identity_total_count annotations
{
  "title": "Count Registered Agents",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_identity_register — Register Agent
Advertised by the server during the last successful anonymous check.

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

actora_identity_register input schema
{
  "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_register annotations
{
  "title": "Register Agent",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_subscription_plans — Get Subscription Plan
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_subscription_plans input schema
{
  "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_plans annotations
{
  "title": "Get Subscription Plan",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_subscription_check — Check Subscription
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_subscription_check input schema
{
  "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_check annotations
{
  "title": "Check Subscription",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_subscription_detail — Get Subscription Detail
Advertised by the server during the last successful anonymous check.
Advertised read-only

Full subscription detail including trial info, escrow status.

actora_subscription_detail input schema
{
  "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_detail annotations
{
  "title": "Get Subscription Detail",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_subscription_my_list — List My Subscriptions
Advertised by the server during the last successful anonymous check.
Advertised read-only

List all subscription IDs for a wallet.

actora_subscription_my_list input schema
{
  "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_my_list annotations
{
  "title": "List My Subscriptions",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_subscription_subscribe — Subscribe to Plan
Advertised by the server during the last successful anonymous check.

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.

actora_subscription_subscribe input schema
{
  "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_subscribe annotations
{
  "title": "Subscribe to Plan",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_subscription_cancel — Cancel Subscription
Advertised by the server during the last successful anonymous check.
Advertised destructive

Cancel a subscription. WRITE operation.

actora_subscription_cancel input schema
{
  "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_cancel annotations
{
  "title": "Cancel Subscription",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_subscription_release — Release Subscription (Deprecated)
Advertised by the server during the last successful anonymous check.

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

actora_subscription_release input schema
{
  "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_release annotations
{
  "title": "Release Subscription (Deprecated)",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_subscription_fee — Get Platform Fee
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get current platform fee in bps.

actora_subscription_fee input schema
{
  "type": "object",
  "properties": {
    "chain": {
      "enum": [
        "bsc",
        "ethereum",
        "base"
      ],
      "type": "string",
      "description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
    }
  }
}
actora_subscription_fee annotations
{
  "title": "Get Platform Fee",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_subscription_create_plan — Create Subscription Plan
Advertised by the server during the last successful anonymous check.

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.

actora_subscription_create_plan input schema
{
  "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)"
    }
  }
}
actora_subscription_create_plan annotations
{
  "title": "Create Subscription Plan",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_central_agent_list — List Central Agents
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

actora_central_agent_list input schema
{
  "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_list annotations
{
  "title": "List Central Agents",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_central_subscription_check — Check Central Subscription
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

actora_central_subscription_check input schema
{
  "type": "object",
  "required": [
    "subscriber",
    "agentId"
  ],
  "properties": {
    "agentId": {
      "type": "integer",
      "description": "Centralized agent ID (negative)"
    },
    "subscriber": {
      "type": "string",
      "description": "Wallet address (0x...)"
    }
  }
}
actora_central_subscription_check annotations
{
  "title": "Check Central Subscription",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_central_agent_create — Create Central Agent
Advertised by the server during the last successful anonymous check.

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.

actora_central_agent_create input schema
{
  "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_create annotations
{
  "title": "Create Central Agent",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_central_agent_update — Update Central Agent
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

actora_central_agent_update input schema
{
  "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_agent_update annotations
{
  "title": "Update Central Agent",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_central_subscription_subscribe — Subscribe Central Agent
Advertised by the server during the last successful anonymous check.
Advertised destructive

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.

actora_central_subscription_subscribe input schema
{
  "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_central_subscription_subscribe annotations
{
  "title": "Subscribe Central Agent",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_a2a_create_task — Create A2A Task
Advertised by the server during the last successful anonymous check.

Create an on-chain A2A task. WRITE operation.

actora_a2a_create_task input schema
{
  "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_create_task annotations
{
  "title": "Create A2A Task",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_a2a_get_task — Get A2A Task
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get A2A task details.

actora_a2a_get_task input schema
{
  "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_get_task annotations
{
  "title": "Get A2A Task",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_a2a_complete_task — Complete A2A Task
Advertised by the server during the last successful anonymous check.
Advertised destructive

Complete a task on-chain. WRITE operation.

actora_a2a_complete_task input schema
{
  "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_complete_task annotations
{
  "title": "Complete A2A Task",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_a2a_my_tasks — List My A2A Tasks
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get all task IDs for a wallet.

actora_a2a_my_tasks input schema
{
  "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_a2a_my_tasks annotations
{
  "title": "List My A2A Tasks",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_a2a_agent_card — Get Agent A2A Card
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_a2a_agent_card input schema
{
  "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_agent_card annotations
{
  "title": "Get Agent A2A Card",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_agent_call — Call Agent (Pay Per Call)
Advertised by the server during the last successful anonymous check.

Call a published agent and return its reply. When the caller has no subscription, this pays the publisher per call in USDC from the caller smart account (direct to the publisher, no platform escrow). If payment is not authorized yet it returns error="payment_required" with paymentRequired.authorizeUrl — ask the user to open the link, authorize a USDC budget, then retry this tool with the same refId. Requires access_token (registered-user JWT).

actora_agent_call input schema
{
  "type": "object",
  "required": [
    "agentId",
    "input"
  ],
  "properties": {
    "chain": {
      "enum": [
        "bsc",
        "ethereum",
        "base"
      ],
      "type": "string",
      "description": "Chain: \"bsc\" (default) | \"ethereum\" | \"base\". Sepolia testnet is not supported."
    },
    "input": {
      "type": "string",
      "description": "Request or instruction sent to the agent"
    },
    "refId": {
      "type": "string",
      "description": "Idempotency key; reuse it when retrying after authorization"
    },
    "agentId": {
      "type": "integer",
      "description": "Published agent ID (positive on-chain id)"
    },
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — registered-user auth (required)"
    }
  }
}
actora_agent_call annotations
{
  "title": "Call Agent (Pay Per Call)",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_reputation_rate — Rate Agent
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

actora_reputation_rate input schema
{
  "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_rate annotations
{
  "title": "Rate Agent",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_reputation_get — Get Agent Rating
Advertised by the server during the last successful anonymous check.
Advertised read-only

Average rating and review count.

actora_reputation_get input schema
{
  "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_get annotations
{
  "title": "Get Agent Rating",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_reputation_reviews — List Agent Reviews
Advertised by the server during the last successful anonymous check.
Advertised read-only

All reviews with reviewer, rating, comment, timestamp.

actora_reputation_reviews input schema
{
  "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_reviews annotations
{
  "title": "List Agent Reviews",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_config_get — Get Agent Config
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_config_get input schema
{
  "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_get annotations
{
  "title": "Get Agent Config",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_config_list — List Agent Config
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_config_list input schema
{
  "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_list annotations
{
  "title": "List Agent Config",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_config_set — Set Agent Config
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

actora_config_set input schema
{
  "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_config_set annotations
{
  "title": "Set Agent Config",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_endpoint_list — List Agent Endpoints
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_endpoint_list input schema
{
  "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 annotations
{
  "title": "List Agent Endpoints",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_endpoint_active — List Live Endpoints
Advertised by the server during the last successful anonymous check.
Advertised read-only

Only live endpoints from the platform DB.

actora_endpoint_active input schema
{
  "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_active annotations
{
  "title": "List Live Endpoints",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_endpoint_best_mcp — Get Best MCP Endpoint
Advertised by the server during the last successful anonymous check.
Advertised read-only

Best available MCP endpoint URL from the platform DB.

actora_endpoint_best_mcp input schema
{
  "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 annotations
{
  "title": "Get Best MCP Endpoint",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_endpoint_status — Get Endpoint Health
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_endpoint_status input schema
{
  "type": "object",
  "required": [
    "access_token"
  ],
  "properties": {
    "access_token": {
      "type": "string",
      "description": "Gateway JWT — owner auth (required)"
    }
  }
}
actora_endpoint_status annotations
{
  "title": "Get Endpoint Health",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_gateway_health — Gateway Health
Advertised by the server during the last successful anonymous check.
Advertised read-only

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

actora_gateway_health input schema
{
  "type": "object",
  "properties": {}
}
actora_gateway_health annotations
{
  "title": "Gateway Health",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_listing_get — Get Marketplace Listing
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

actora_listing_get input schema
{
  "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_get annotations
{
  "title": "Get Marketplace Listing",
  "readOnlyHint": true,
  "destructiveHint": false
}
actora_listing_set — Publish or Update Listing
Advertised by the server during the last successful anonymous check.
Advertised destructive

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.

actora_listing_set input schema
{
  "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)"
    }
  }
}
actora_listing_set annotations
{
  "title": "Publish or Update Listing",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_listing_price — Update Listing Price
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

actora_listing_price input schema
{
  "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_price annotations
{
  "title": "Update Listing Price",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_listing_delist — Delist Agent
Advertised by the server during the last successful anonymous check.
Advertised destructive

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

actora_listing_delist input schema
{
  "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_delist annotations
{
  "title": "Delist Agent",
  "readOnlyHint": false,
  "destructiveHint": true
}
actora_endpoint_probe — Probe Agent Endpoint
Advertised by the server during the last successful anonymous check.

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

actora_endpoint_probe input schema
{
  "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_probe annotations
{
  "title": "Probe Agent Endpoint",
  "readOnlyHint": false,
  "destructiveHint": false
}
actora_payload_key_list — List Payload Keys
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

actora_payload_key_list input schema
{
  "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_payload_key_list annotations
{
  "title": "List Payload Keys",
  "readOnlyHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-07: 1 of 1 checks answered
  2. 2026-11-09: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1937 ms
95th percentile latency
1937 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1937 ms · metadata changed · 44 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http actora-platform-mcp https://actora.codes/mcp/platform

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add actora-platform-mcp --url https://actora.codes/mcp/platform

Cursor

Merge this server into .cursor/mcp.json in your project, then enable actora-platform-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "actora-platform-mcp": {
      "url": "https://actora.codes/mcp/platform"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "actora-platform-mcp": {
      "type": "streamableHttp",
      "url": "https://actora.codes/mcp/platform",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start actora-platform-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "actora-platform-mcp": {
      "type": "http",
      "url": "https://actora.codes/mcp/platform"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http actora-platform-mcp https://actora.codes/mcp/platform

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://actora.codes/mcp/platform

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "actora-platform-mcp": {
      "serverUrl": "https://actora.codes/mcp/platform"
    }
  }
}

Let your agent find its tools

Find servers like Actora Platform MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.