Actora Tenant — Hosted Chat, Tasks & Usage
Actora B-side tools: hosted chat, sessions, tasks, tenant plan and usage.
¿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": {
"actora-tenant": {
"url": "https://actora.codes/mcp/tenant"
}
}
}Puntos de conexión remotos
https://actora.codes/mcp/tenantstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (9)
🟢actora_gateway_tenant(access_token, accessToken)
Get tenant profile, plan, quota. Requires access_token (registered-user JWT); `Authorization: Bearer` is injected automatically.
Esquema de entrada
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT token (registered-user auth)"
},
"accessToken": {
"type": "string",
"description": "Deprecated alias of access_token"
}
}
}⚪actora_gateway_chat(message, agent_id, prompt, history, tenant_key_id, ...)
Single-turn conversation with an agent (SSE stream collected into a reply). Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "User message"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt (bypasses agent lookup)"
},
"history": {
"type": "array",
"description": "Optional conversation history [{role, content}]"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"message"
]
}🟡actora_gateway_create_session(agent_id, title, access_token)
Create a conversation session (dialog container; idempotent). Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"description": "Agent ID"
},
"title": {
"type": "string",
"description": "Optional session title"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
}
}🟡actora_gateway_create_task(session_id, message, agent_id, prompt, tenant_key_id, ...)
Create a background task in a session (returns immediately with taskId; queued→running→done). May return 403 PARALLEL_TASKS_DISABLED. Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID (from actora_gateway_create_session)"
},
"message": {
"type": "string",
"description": "Task instruction"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id",
"message"
]
}🟢actora_gateway_get_task(task_id, access_token)
Get task detail by id (status, result, error). Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_gateway_list_tasks(session_id, access_token)
List all tasks of a session. Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id"
]
}🔴actora_gateway_cancel_task(task_id, access_token)
Cancel a task (queued → cancelled; running → aborted; terminal states are idempotent). Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_tenant_plans(access_token)
List platform plans for B-side tenants (Free / Pro / Enterprise: quota, rate limit, concurrency, BYOK). Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}⚪actora_tenant_usage(days, access_token)
Token/tool-call usage summary and daily timeline for the current tenant. Requires access_token (registered-user JWT).
Esquema de entrada
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback window in days (1..365, default 30)"
},
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}Comunidad
Evidencia