ClawStud MCP
Ask your clients' data in plain language.
ClawStud has an MCP server. Connect it to your AI and stop switching tabs: ask what a client's traffic did, which searches fell, or how the month closed — and get an answer from your own data.
The plain facts
- 28 tools
- 28
- Endpoint
- api.clawstud.com/api/portal/mcp
- ChatGPT · Claude
- api.clawstud.com/mcp
- Transport
- Streamable HTTP
- Auth
- Token (csk_…) · OAuth 2.0
What you can ask
- ¿Qué ha pasado con el tráfico de la tienda Norte este mes?
- ¿Qué búsquedas han caído en el cliente de-alcohol?
- ¿Cómo cerró el mes en ingresos netos?
- ¿Qué campañas de email abrieron mejor?
- ¿Qué despliegues salieron a producción la semana pasada?
- ¿Qué compradores se están enfriando?
Connect it in one command
Create it in the portal under Settings → API keys. It starts with csk_ and you can give it only the scopes it needs.
# Your API token
claude mcp add --transport http clawstud https://api.clawstud.com/api/portal/mcp
--header "Authorization: Bearer csk_…"
claude mcp add --transport http clawstud https://api.clawstud.com/api/portal/mcp
--header "Authorization: Bearer csk_…"
No signup needed to read this page.
28 tools
get_overviewEmpieza por aquí. Todo lo que tengas conectado para un periodo, cada fuente con su cambio respecto al periodo anterior.get_trafficGoogle Analytics: sesiones, usuarios, páginas vistas, engagement, ecommerce, canales, dispositivos, páginas más vistas y serie temporal.get_searchGoogle Search Console: clics, impresiones, CTR, posición media, países y las búsquedas que traen gente, con sus cambios.get_salesStripe: saldo, MRR y suscripciones activas ahora, y para el periodo ingresos, netos, pagos, devoluciones y clientes nuevos.get_emailsLos correos que envió la tienda (Resend) en un periodo: enviados, entregados, abiertos, clics, rebotes, quejas de spam y sus tasas.get_behaviorComportamiento en la web (PostHog): usuarios únicos, sesiones, páginas vistas, páginas más vistas y los eventos de tu propia app.get_deploysDespliegues del sitio (Vercel/Netlify): qué hay en producción, despliegues y fallos, tasa de éxito y tiempo medio hasta estar vivo.list_buyersLos compradores de la tienda desde Stripe (scope read:customers): nombre, email, país, pedidos, gastado y segmento. Paginada: pasa `cursor` para continuar donde lo dejó la última llamada (la respuesta incluye `next_cursor` mientras haya más).get_buyerUn comprador por email (scope read:customers): cada pedido con sus devoluciones, totales y notas.list_usersQuién se ha registrado en la app (Supabase, scope read:customers): email, nombre y fecha.list_workspacesTodos los espacios de trabajo a los que puede acceder esta clave. Devuelve id, nombre y slug.list_top_pagesPáginas top de un workspace en un periodo, desde GA4 (por visitas) o GSC (por clics, con impresiones y CTR). GA4 devuelve las páginas que más visitas reciben; GSC devuelve las páginas por las que Search Console dice que la tienda aparece, ordenadas por clics con impresiones y CTR. Si la integración GSC solo expone `queries` (caso del demo hoy), la herramienta cae a queries y lo explica en las notas. Solo lectura.create_social_draftEscribe un borrador de post en la cola de aprobación. NO se publica: una persona tiene que aprobarlo en el panel, y solo los_posts aprobados con hora elegida salen. Proveedores admitidos: meta (Página de Facebook / Instagram Business) y tiktok. X/Twitter no está admitido. Úsala para redactar contenido y luego list_social_drafts para ver qué queda pendiente de revisión.list_social_draftsLista los borradores de redes de este workspace con su estado de revisión (draft / pending_media / scheduled / published / rejected / failed). Úsala después de create_social_draft para ver qué espera a una persona, o para comprobar si se aprobó un borrador anterior. Solo lectura.list_anomaly_signalsCruza integraciones (OAuth health) + alertas (stock, churn, etc.) + compare_periods (caídas en tráfico, ventas, emails…). Una sola llamada que dice qué necesita atención AHORA en este workspace, ordenado crítico → warning → info y deduplicado. Es el diferenciador: el LLM pregunta "¿qué va mal?" y obtiene una sola respuesta en lugar de hacer fan-out a tres tools. Solo lectura.list_workspace_membersQuién tiene acceso al espacio de trabajo: email enmascarado por defecto (pasa include_email para ver el real), rol, estado, fecha de alta y días desde entonces. Ordenado por rol (owner primero), luego por fecha de alta. Miembros con estado `removed` quedan excluidos salvo que se pida include_removed. Devuelve un bloque por cada workspace al que la clave puede acceder. Solo lectura.get_workspace_subscriptionEstado de la suscripción de un workspace: plan (free / starter / pro / business / lifetime / unknown), status, cuándo acaba el periodo actual, días restantes de trial si está en pruebas, y notas de aviso (past_due, trial por acabar, lifetime, price id desconocido). Solo lectura.get_workspace_metricsResumen compacto de GA4 + Search Console de un espacio de trabajo, el más reciente.get_gsc_breakdownDesglose de Search Console por espacio de trabajo: clics, impresiones, CTR y posición.search_audit_logBusca en el registro de auditoría de la cuenta que llama. Devuelve los eventos más recientes.compare_periodsCompara la misma fuente entre dos periodos (este mes contra el mismo mes del año pasado, o cualquier par de ventanas) y devuelve la respuesta que un LLM puede usar: deltas absolutos y porcentuales por métrica, la sub-métrica (canal, país, búsqueda o evento) con la mayor caída absoluta, y avisos sobre datos incompletos, periodos idénticos o lecturas parciales. Fuentes: traffic, search, sales, emails, behavior, deploys. Solo lectura: nunca escribe nada.list_integrationsLista todas las integraciones de datos del workspace del API key, los recursos del dashboard que alimenta cada una (GA4, GSC, Stripe, Resend, PostHog, Vercel/Netlify, Supabase) y un estado limpio (live, expiring_soon, expired, error, pending) con avisos de tokens caducados. Úsala ANTES de las otras tools cuando necesitas saber qué fuentes están realmente conectadas — por ejemplo, cuando la respuesta a una pregunta depende de si GA4 sigue enlazado. Solo lectura.list_alertsLista todas las alertas que necesitan atención en el workspace del API key — tanto alertas genéricas (campana del portal) como alertas de stock bajo — ordenadas de más reciente a más antigua, con severidad, antigüedad y estado leído/descartado. Úsala cuando alguien pregunta "¿algo va mal ahora mismo?" — una sola llamada contesta "¿este cliente necesita atención hoy?" sin hacer un tour por la UI. Solo lectura: nunca marca alertas como leídas ni como descartadas.get_alertDevuelve una sola alerta por id (funciona tanto para alertas genéricas como de stock). Úsala cuando el LLM ha visto algo en list_alerts y quiere el body / payload / link sin re-listar. Solo lectura.get_ga4_breakdownDesglose GA4 por workspace: para cada cliente conectado, devuelve sus sesiones, usuarios, engagement y serie temporal de los últimos 30 días en una sola llamada. Úsala cuando el LLM pide "dame todos los GA4 que tengo" o quiere comparar el rendimiento de varios clientes lado a lado sin pedir uno por uno. Auto-scopeada al workspace del API key. Solo lectura.get_workspace_pnlIngresos (Stripe ventas, reembolsos, comisiones, neto, pagos) menos gastos del workspace del API key en su propia moneda. Es la cifra real de lo que el cliente ha ganado después de comisiones de Stripe y gastos del workspace — la que más le importa al dueño de una agencia y que ningún otro servidor MCP de este espacio expone. El periodo anterior viene gratis: "cómo cambió el resultado frente al mes pasado" tiene respuesta directa. Solo lectura. Fuentes: Stripe (ingresos) y la tabla de gastos del workspace.get_pnl_breakdownEn qué se van realmente los gastos del workspace, agrupados por categoría, proveedor o recurrencia. Úsala después de get_workspace_pnl: esa da la cifra grande (resultado, margen, cambio), esta la explica. `category` responde "¿en qué se fue el dinero?", `vendor` "¿a quién pagamos?" y `recurrence` "¿cuáles son mis costes fijos?" — recurrence normaliza los gastos anuales a cifra mensual y separa fixedCostTotal de variableCostTotal, para que una campaña puntual no se confunda con un aumento permanente de costes. Si hay filas en otra moneda, la respuesta lo dice en las notas en vez de sumarlas en silencio. Solo lectura.explain_metricDime qué significa realmente una métrica. Devuelve la definición canónica de una métrica concreta (sessions, MRR, CTR, result del P&L, etc.), lo que cuenta, lo que excluye y qué tool MCP la expone. Las definiciones vienen de las docs públicas de cada proveedor (Google, Stripe, Resend, PostHog, Vercel/Netlify), nunca se inventan. Úsala antes de responder una pregunta que depende de la definición de una cifra — por ejemplo, "¿el MRR incluye los pagos únicos?" o "¿el result del P&L descuenta los gastos?" — para que el modelo no parafrasee la métrica y la distorsione. Solo lectura.
Scopes, so the AI sees only what you allow
Every tool only reads, except one that saves social post drafts — and a draft only goes out after you approve it in the portal. The MCP cannot send anything or change a setting.
How it authenticates
Two ways in. With a token (Claude Code, Cursor, VS Code, Claude Desktop): one bearer token with per-tool scopes and all 28 tools. With ChatGPT or Claude connectors: you sign in with OAuth 2.0 and approve once — 24 read-only tools, without your customers' personal data or drafts.
Try it on your own data
Create a free workspace and connect one client in about two minutes.