AgentsPodium Hosting
Create, watch, pay for and connect hosted AI agent pods on AgentsPodium. Needs an API key.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"hosting": {
"url": "https://mcp.agentspodium.com/mcp"
}
}
}Puntos de conexión remotos
https://mcp.agentspodium.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (13)
🟢list_platforms
List available AgentsPodium engines (platforms) and hosting plans (tiers), with prices and capabilities.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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).
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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#"
}Esquema de salida
{
"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#"
}Comunidad
Evidencia