MCP 服务器

AgentsPodium Hosting

com.agentspodium/hosting
AI 与智能体 云与基础设施 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Deploys and manages hosted AI agent instances, including health, billing, LLM keys, peers, webhooks, pausing, and rebuilding.

create_instance
Create instance
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', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['tier'], 'properties': {'name': {'type': 'string', 'maxLength': 60, 'minLength': 1, 'description': 'Display name for the instance.'}, 'tier': {'enum': ['tiny', 'small', 'medium', 'large'], 'type': 'string', 'description': 'Hosting plan controlling RAM/CPU/disk. See list_platforms for prices.'}, 'model': {'type': 'string', 'maxLength': 200, 'description': 'Default LLM model id for the engine.'}, 'domain': {'type': 'string', 'maxLength': 253, 'description': 'Customer-owned domain to serve the instance from.'}, 'engine': {'type': 'string', 'default': 'hermes', 'minLength': 1, 'description': "Runtime engine id (e.g. hermes, openclaw, n8n). See list_platforms for what's available."}, 'channels': {'type': 'array', 'items': {'enum': ['web', 'telegram', 'discord', 'whatsapp', 'email'], 'type': 'string'}, 'minItems': 1, 'description': 'Channels to enable (web, telegram, ...).'}, 'enableA2A': {'type': 'boolean', 'default': True, 'description': 'Turn on the A2A toolset and issue an a2aUrl/a2aToken for this instance.'}, 'extraSoul': {'type': 'string', 'maxLength': 4000, 'description': 'Extra system-prompt instructions appended to the persona.'}, 'personaId': {'type': 'string', 'default': 'personal-assistant', 'minLength': 1, 'description': 'Persona/template id from list_platforms; defaults to the general-purpose 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.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'status', 'endpointUrl', 'a2aUrl', 'a2aToken', 'webhookSecret', 'next'], 'properties': {'id': {'type': 'string', 'description': 'Newly created instance id.'}, 'next': {'type': 'string', 'description': 'Suggested next step for the caller.'}, 'a2aUrl': {'type': ['string', 'null'], 'description': 'A2A endpoint, or null if A2A was not enabled.'}, 'status': {'type': 'string', 'description': 'Initial lifecycle status.'}, 'a2aToken': {'type': ['string', 'null'], 'description': 'A2A bearer token to keep, or null if A2A was not enabled.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint, or null until assigned.'}, 'webhookSecret': {'type': ['string', 'null'], 'description': 'HMAC key for webhook signatures when webhookUrl was given (shown once), else null.'}}, 'additionalProperties': False}
delete_instance
Delete instance
Permanently delete an instance. This cannot be undone.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok', 'id'], 'properties': {'id': {'type': 'string', 'description': 'Id of the deleted instance.'}, 'ok': {'type': 'boolean', 'const': True, 'description': 'Always true on success.'}}, 'additionalProperties': False}
get_instance_health
Check instance health
Check whether an instance is reachable and serving, plus its status and quota state.
只读 可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'status', 'quotaStatus', 'reachable', 'serving'], 'properties': {'id': {'type': 'string', 'description': 'Instance id checked.'}, 'status': {'type': 'string', 'description': 'Lifecycle status reported by the account API.'}, 'serving': {'type': ['boolean', 'null'], 'description': 'Whether the instance is currently answering requests, or null if unknown.'}, 'reachable': {'type': ['boolean', 'null'], 'description': "Whether the instance's endpoint responded, or null if unknown."}, 'quotaStatus': {'type': ['string', 'null'], 'description': 'Usage quota status, or null if not tracked.'}}, 'additionalProperties': False}
get_instance_term
Get billing term
Get the billing term (trial/paid/grace) for an instance, including when it renews or expires.
只读 可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['term'], 'properties': {'term': {'type': 'object', 'description': 'Billing term details (status, renewal/expiry dates, etc.), as returned by the account API.', 'additionalProperties': {}}}, 'additionalProperties': False}
get_payment_options
Get payment options
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', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['crypto', 'stars'], 'properties': {'term': {'description': "The instance's current billing term."}, 'stars': {'type': 'object', 'description': "Telegram Stars payment info (beta testing), as returned by the account API, plus an added 'note' field.", 'additionalProperties': {}}, 'crypto': {'type': 'object', 'description': "Crypto payment info (beta testing), as returned by the account API, plus an added 'note' field.", 'additionalProperties': {}}, 'providers': {'description': 'Card/subscription payment providers and buy links, as returned by the account API.'}}, 'additionalProperties': False}
list_instances
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', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['instances'], 'properties': {'instances': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}, 'description': "The caller's instances."}}, 'additionalProperties': False}
list_platforms
List platforms and plans
List available AgentsPodium engines (platforms) and hosting plans (tiers), with prices and capabilities.
只读 可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['engines', 'tiers'], 'properties': {'tiers': {'type': 'array', 'items': {}, 'description': 'Available hosting plans (tiers) with prices, as published by the account API.'}, 'engines': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'label', 'minTier', 'status'], 'properties': {'id': {'type': 'string', 'description': 'Engine id (e.g. hermes).'}, 'label': {'type': 'string', 'description': 'Human-readable engine name.'}, 'status': {'type': 'string', 'description': 'Engine availability status (e.g. stable, beta).'}, 'minTier': {'type': 'string', 'description': 'Cheapest tier this engine can run on.'}, 'capabilities': {'description': 'Engine-specific capability flags, as published by the account API.'}}, 'additionalProperties': False}, 'description': 'Available runtime engines.'}}, 'additionalProperties': False}
pause_instance
Pause instance
Pause an instance: stops it and its billing lease. Data is archived, not deleted.
可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}
rebuild_instance
Rebuild instance
Rebuild an instance's pod (e.g. after a config change that needs a restart).
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}
resume_instance
Resume instance
Resume a previously paused instance, rebuilding it from its archive.
可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}
set_llm_key
Set LLM key
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', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'provider', 'key'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}, '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.'}, 'provider': {'type': 'string', 'minLength': 1, 'description': 'LLM provider id, e.g. openai, anthropic, deepseek.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}
set_peers
Set A2A peers
Set the list of other A2A agents this instance is allowed to call by name.
可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'peers'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id whose peer list is being set.'}, 'peers': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'A2A JSON-RPC endpoint URL of the peer agent.'}, 'name': {'type': 'string', 'maxLength': 64, 'minLength': 1, 'description': 'Name other agents use to address this peer over A2A.'}, 'token': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': 'Bearer token to send when calling this peer, if it requires one.'}}, 'additionalProperties': False}, 'maxItems': 20, 'description': 'Full replacement list of peer agents this instance may call (up to 20).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'name', 'engine', 'tier', 'status', 'endpointUrl', 'a2aUrl', 'domain', 'createdAt'], 'properties': {'id': {'type': 'string', 'description': 'Instance (agent) id.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'tier': {'type': 'string', 'description': 'Hosting plan id.'}, '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.'}, 'engine': {'type': 'string', 'description': 'Runtime engine id (e.g. hermes).'}, 'status': {'type': 'string', 'description': 'Lifecycle status (e.g. running, stopped).'}, 'createdAt': {'type': 'string', 'description': 'ISO timestamp when the instance was created.'}, 'endpointUrl': {'type': ['string', 'null'], 'description': 'Public HTTPS endpoint for the instance, or null if not yet assigned.'}}, 'additionalProperties': False}
set_webhook
Set event webhook
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', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'url'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Instance (agent) id, as returned by create_instance or list_instances.'}, 'url': {'type': 'string', 'maxLength': 500, 'minLength': 8, 'description': 'Public http(s) URL to POST signed pod events to. Private and loopback hosts are refused.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'url', 'secret', 'events'], 'properties': {'id': {'type': 'string', 'description': 'Instance id.'}, 'url': {'type': 'string', 'description': 'The webhook URL now in effect.'}, 'events': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Event types that will be delivered.'}, 'secret': {'type': 'string', 'description': 'HMAC-SHA256 key for X-AgentsPodium-Signature. Shown once — store it.'}}, 'additionalProperties': False}
已添加
set_webhook
2026年9月17日 12:33
已添加
set_peers
2026年9月17日 12:33
已添加
get_payment_options
2026年9月17日 12:33
已添加
delete_instance
2026年9月17日 12:33
已添加
rebuild_instance
2026年9月17日 12:33
已添加
resume_instance
2026年9月17日 12:33
已添加
pause_instance
2026年9月17日 12:33
已添加
set_llm_key
2026年9月17日 12:33
已添加
get_instance_term
2026年9月17日 12:33
已添加
get_instance_health
2026年9月17日 12:33
已添加
create_instance
2026年9月17日 12:33
已添加
list_instances
2026年9月17日 12:33
已添加
list_platforms
2026年9月17日 12:33