AgentsPodium Hosting
Create, watch, pay for and connect hosted AI agent pods on AgentsPodium. Needs an API key.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高,可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案:
{
"mcpServers": {
"hosting": {
"url": "https://mcp.agentspodium.com/mcp"
}
}
}遠端端點
https://mcp.agentspodium.com/mcpstreamable-http它能做什麼
工具清單
工具(13)
🟢list_platforms
List available AgentsPodium engines (platforms) and hosting plans (tiers), with prices and capabilities.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"engines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Engine id (e.g. hermes)."
},
"label": {
"type": "string",
"description": "Human-readable engine name."
},
"minTier": {
"type": "string",
"description": "Cheapest tier this engine can run on."
},
"status": {
"type": "string",
"description": "Engine availability status (e.g. stable, beta)."
},
"capabilities": {
"description": "Engine-specific capability flags, as published by the account API."
}
},
"required": [
"id",
"label",
"minTier",
"status"
],
"additionalProperties": false
},
"description": "Available runtime engines."
},
"tiers": {
"type": "array",
"items": {},
"description": "Available hosting plans (tiers) with prices, as published by the account API."
}
},
"required": [
"engines",
"tiers"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_instances
List the caller's AgentsPodium instances (agents): id, name, engine, tier, status, endpoint and A2A URL, domain, creation date. Never returns secrets.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"instances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false
},
"description": "The caller's instances."
}
},
"required": [
"instances"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_instance(personaId, engine, tier, name, channels, ...)
Create (deploy) a new AgentsPodium instance. Returns the instance id and, when enableA2A is true, the a2aUrl and a2aToken the caller should keep. After creating, poll get_instance_health until it is serving, then call set_llm_key to give it a working LLM key.
輸入結構描述
{
"type": "object",
"properties": {
"personaId": {
"type": "string",
"minLength": 1,
"default": "personal-assistant",
"description": "Persona/template id from list_platforms; defaults to the general-purpose persona."
},
"engine": {
"type": "string",
"minLength": 1,
"default": "hermes",
"description": "Runtime engine id (e.g. hermes, openclaw, n8n). See list_platforms for what's available."
},
"tier": {
"type": "string",
"enum": [
"tiny",
"small",
"medium",
"large"
],
"description": "Hosting plan controlling RAM/CPU/disk. See list_platforms for prices."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "Display name for the instance."
},
"channels": {
"type": "array",
"items": {
"type": "string",
"enum": [
"web",
"telegram",
"discord",
"whatsapp",
"email"
]
},
"minItems": 1,
"description": "Channels to enable (web, telegram, ...)."
},
"model": {
"type": "string",
"maxLength": 200,
"description": "Default LLM model id for the engine."
},
"enableA2A": {
"type": "boolean",
"default": true,
"description": "Turn on the A2A toolset and issue an a2aUrl/a2aToken for this instance."
},
"domain": {
"type": "string",
"maxLength": 253,
"description": "Customer-owned domain to serve the instance from."
},
"extraSoul": {
"type": "string",
"maxLength": 4000,
"description": "Extra system-prompt instructions appended to the persona."
},
"webhookUrl": {
"type": "string",
"maxLength": 500,
"description": "Public http(s) URL to receive signed pod events (agent.running, agent.stopped, agent.failed, agent.deleted, payment.confirmed, deletion.warning) instead of polling. The signing secret comes back once as webhookSecret."
}
},
"required": [
"tier"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Newly created instance id."
},
"status": {
"type": "string",
"description": "Initial lifecycle status."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint, or null until assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A endpoint, or null if A2A was not enabled."
},
"a2aToken": {
"type": [
"string",
"null"
],
"description": "A2A bearer token to keep, or null if A2A was not enabled."
},
"webhookSecret": {
"type": [
"string",
"null"
],
"description": "HMAC key for webhook signatures when webhookUrl was given (shown once), else null."
},
"next": {
"type": "string",
"description": "Suggested next step for the caller."
}
},
"required": [
"id",
"status",
"endpointUrl",
"a2aUrl",
"a2aToken",
"webhookSecret",
"next"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_instance_health(id)
Check whether an instance is reachable and serving, plus its status and quota state.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance id checked."
},
"status": {
"type": "string",
"description": "Lifecycle status reported by the account API."
},
"quotaStatus": {
"type": [
"string",
"null"
],
"description": "Usage quota status, or null if not tracked."
},
"reachable": {
"type": [
"boolean",
"null"
],
"description": "Whether the instance's endpoint responded, or null if unknown."
},
"serving": {
"type": [
"boolean",
"null"
],
"description": "Whether the instance is currently answering requests, or null if unknown."
}
},
"required": [
"id",
"status",
"quotaStatus",
"reachable",
"serving"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_instance_term(id)
Get the billing term (trial/paid/grace) for an instance, including when it renews or expires.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"term": {
"type": "object",
"additionalProperties": {},
"description": "Billing term details (status, renewal/expiry dates, etc.), as returned by the account API."
}
},
"required": [
"term"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡set_llm_key(id, provider, key, model)
Set (or clear, with key=null) the LLM provider API key an instance uses to answer. Required before a freshly created instance can actually respond.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
},
"provider": {
"type": "string",
"minLength": 1,
"description": "LLM provider id, e.g. openai, anthropic, deepseek."
},
"key": {
"type": "string",
"minLength": 1,
"description": "The provider API key. Stored encrypted, never echoed back."
},
"model": {
"type": "string",
"maxLength": 200,
"description": "Model id to use with this provider (e.g. gpt-4o-mini). Optional; the engine defaults if omitted."
}
},
"required": [
"id",
"provider",
"key"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪pause_instance(id)
Pause an instance: stops it and its billing lease. Data is archived, not deleted.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪resume_instance(id)
Resume a previously paused instance, rebuilding it from its archive.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴rebuild_instance(id)
Rebuild an instance's pod (e.g. after a config change that needs a restart).
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_instance(id)
Permanently delete an instance. This cannot be undone.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true,
"description": "Always true on success."
},
"id": {
"type": "string",
"description": "Id of the deleted instance."
}
},
"required": [
"ok",
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_payment_options(id)
Get ways to pay for an instance's plan: card/subscription buy links, crypto payment info, and Telegram Stars info (crypto and Stars are in beta testing), plus the instance's current term.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"providers": {
"description": "Card/subscription payment providers and buy links, as returned by the account API."
},
"crypto": {
"type": "object",
"additionalProperties": {},
"description": "Crypto payment info (beta testing), as returned by the account API, plus an added 'note' field."
},
"stars": {
"type": "object",
"additionalProperties": {},
"description": "Telegram Stars payment info (beta testing), as returned by the account API, plus an added 'note' field."
},
"term": {
"description": "The instance's current billing term."
}
},
"required": [
"crypto",
"stars"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡set_peers(id, peers)
Set the list of other A2A agents this instance is allowed to call by name.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id whose peer list is being set."
},
"peers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Name other agents use to address this peer over A2A."
},
"url": {
"type": "string",
"format": "uri",
"description": "A2A JSON-RPC endpoint URL of the peer agent."
},
"token": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Bearer token to send when calling this peer, if it requires one."
}
},
"required": [
"name",
"url"
],
"additionalProperties": false
},
"maxItems": 20,
"description": "Full replacement list of peer agents this instance may call (up to 20)."
}
},
"required": [
"id",
"peers"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance (agent) id."
},
"name": {
"type": "string",
"description": "Display name."
},
"engine": {
"type": "string",
"description": "Runtime engine id (e.g. hermes)."
},
"tier": {
"type": "string",
"description": "Hosting plan id."
},
"status": {
"type": "string",
"description": "Lifecycle status (e.g. running, stopped)."
},
"endpointUrl": {
"type": [
"string",
"null"
],
"description": "Public HTTPS endpoint for the instance, or null if not yet assigned."
},
"a2aUrl": {
"type": [
"string",
"null"
],
"description": "A2A JSON-RPC endpoint for the instance, or null if A2A is not enabled."
},
"domain": {
"type": [
"string",
"null"
],
"description": "Customer-owned domain serving the instance, or null."
},
"createdAt": {
"type": "string",
"description": "ISO timestamp when the instance was created."
}
},
"required": [
"id",
"name",
"engine",
"tier",
"status",
"endpointUrl",
"a2aUrl",
"domain",
"createdAt"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡set_webhook(id, url)
Register a URL that receives signed POSTs when the instance comes up, stops, fails, is deleted, when a payment is confirmed and before deletion for non-payment — instead of polling get_instance_health. Returns the HMAC secret once.
輸入結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "Instance (agent) id, as returned by create_instance or list_instances."
},
"url": {
"type": "string",
"minLength": 8,
"maxLength": 500,
"description": "Public http(s) URL to POST signed pod events to. Private and loopback hosts are refused."
}
},
"required": [
"id",
"url"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Instance id."
},
"url": {
"type": "string",
"description": "The webhook URL now in effect."
},
"secret": {
"type": "string",
"description": "HMAC-SHA256 key for X-AgentsPodium-Signature. Shown once — store it."
},
"events": {
"type": "array",
"items": {
"type": "string"
},
"description": "Event types that will be delivered."
}
},
"required": [
"id",
"url",
"secret",
"events"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據