# Console — how to use (mcp.ai)

Marketplace e admin numa superfície só: busque, instale e use MCPs por linguagem natural, e gerencie seu workspace na mcp.ai (toolkits, MCPs, logs, uso). Sem credencial, usa o contexto do seu próprio workspace.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_console?ms=1781044200000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `console_describe`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/console`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/console/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/console/describe` — Detalha um MCP do catálogo (tools, preço, auth, exemplos). Use o `mcp_id` (mcp_…) vindo do console_search.
  - body: { mcp_id: string, mcp_ids?: string[] }
- `POST https://api.mcp.ai/api/console/invoke` — Executa uma tool do toolkit por id, sem depender do cliente ter recarregado a lista (útil logo após o console_mcp_install). Reusa o mesmo pipeline (free-tier/metering/webhook).
  - body: { tool_id: string, arguments?: string, tool_ids?: string[] }
- `POST https://api.mcp.ai/api/console/list/tools` — Lista as tools chamáveis AGORA neste toolkit (inclui as recém-instaladas, mesmo que o cliente ainda não tenha recarregado a lista). Execute-as com console_invoke.
  - body: { query?: string }
- `POST https://api.mcp.ai/api/console/logs/query` — Consulta os logs de requisições do workspace (tool calls, uso de AI, chamadas de API). Filtra por tipo e por sucesso/erro.
  - body: { limit?: integer, kind?: string, status?: string }
- `POST https://api.mcp.ai/api/console/mcp/cancel` — Cancela a assinatura de um MCP. DESTRUTIVO: sem `confirm: true` devolve preview. `immediate: true` cancela agora (perde acesso); default é cancelar no fim do período (mantém acesso até lá).
  - body: { mcp_id: string, immediate?: boolean, confirm?: boolean, mcp_ids?: string[] }
- `POST https://api.mcp.ai/api/console/mcp/install` — Instala um MCP do marketplace no workspace, anexando-o ao toolkit atual (as tools passam a aparecer nesta sessão). Instalar é GRÁTIS — você só paga ao usar além do free tier (via checkout). Use o `mcp
  - body: { mcp_id: string, mcp_ids?: string[] }
- `POST https://api.mcp.ai/api/console/mcp/subscribe` — Assina (ou faz upgrade de) um plano pago de um MCP. Sem `confirm: true` devolve preview. Plano NOVO → devolve um checkout_url pra você abrir e pagar no browser (o agente não cobra sozinho). UPGRADE de
  - body: { mcp_id: string, tier_slug?: string, confirm?: boolean, mcp_ids?: string[] }
- `POST https://api.mcp.ai/api/console/mcp/uninstall` — Desinstala um MCP do workspace (remove credenciais conectadas). DESTRUTIVO: sem `confirm: true` devolve só um preview; passe `confirm: true` pra executar. Bloqueado se houver assinatura ativa (cancele
  - body: { install_id: string, confirm?: boolean, install_ids?: string[] }
- `POST https://api.mcp.ai/api/console/mcps/list` — Lista os MCPs instalados no workspace (status de conexão, categoria, contagem de tools).
- `POST https://api.mcp.ai/api/console/request/mcp` — Pede um MCP/conector NOVO quando o console_search não acha o que você precisa. Registra o pedido pro nosso time avaliar.
  - body: { request_name: string, request_details?: string }
- `POST https://api.mcp.ai/api/console/search` — Busca MCPs no catálogo da mcp.ai por intenção/palavra-chave. Devolve cada resultado com um `mcp_id` (mcp_…), que é exatamente o que você passa pro console_mcp_install.
  - body: { query: string, limit?: integer }
- `POST https://api.mcp.ai/api/console/toolkit/create` — Cria um toolkit no workspace, opcionalmente já anexando MCPs instalados (install ids mi_…).
  - body: { name: string, description?: string, mcp_ids?: string[] }
- `POST https://api.mcp.ai/api/console/toolkit/update` — Edita um toolkit: nome, descrição, instruções pro agente, conjunto de MCPs anexados, ou status.
  - body: { toolkit_id: string, name?: string, description?: string, instructions?: string, mcp_ids?: string[], status?: string }
- `POST https://api.mcp.ai/api/console/toolkits/list` — Lista os toolkits do workspace (nome, status, MCPs anexados, convites de guest).
- `POST https://api.mcp.ai/api/console/usage/summary` — Resumo de uso do workspace no período (total de chamadas, custo, quebra por MCP e por tool).
  - body: { range?: string }

## Example prompts
- "Busque um MCP de Open Finance e me ajude a instalar"
- "Busque um MCP de WhatsApp"
- "Busque um MCP de Instagram"
- "Busque um MCP de Gmail"

## More
- Page: https://mcp.ai/console
- Agent spec (llms.txt): https://mcp.ai/console/llms.txt
- Postman collection: https://mcp.ai/console/postman.json