Agentes de IA (MCP)

Toolsets y herramientas

Cómo expone el servidor MCP de AmICited más de 300 herramientas sin inundar el contexto de tu agente: un pequeño conjunto anunciado, cuatro meta-herramientas para encontrar y ejecutar el resto, y doce toolsets.

Abrir en ChatGPT Abrir en Claude

El servidor MCP de AmICited registra más de 300 herramientas, una para todo lo que puede hacer el dashboard. Entregar todas esas definiciones a un modelo en cada petición consumiría una gran parte de su contexto antes de hacer ningún trabajo, y los modelos eligen peor las herramientas cuando la lista es muy larga. Por eso el servidor las revela de forma progresiva: tu cliente ve una lista corta y el agente busca el resto cuando lo necesita.

No tienes que gestionar nada de esto. Los agentes siguen el patrón por su cuenta, guiados por las instrucciones del servidor y el skill using-amicited. Esta página explica lo que hacen para que puedas leer una transcripción, o acotar la superficie a propósito.

Lo que ve tu cliente#

tools/list anuncia un conjunto pequeño y fijo:

Herramienta	Para qué sirve
`list_domains`	Los dominios del espacio de trabajo, con los ids que necesitan todas las demás herramientas
`list_prompts`	Prompts monitorizados de un dominio
`list_competitors`	Competidores monitorizados de un dominio
`list_tags`	Etiquetas de prompts de un dominio
`prompt_analytics`	Las cifras principales de visibilidad en IA
`report_link`	Un enlace funcional a cualquier informe o página de ajustes de la app
`list_toolsets`	Las doce áreas de producto, una línea cada una, con el número de herramientas
`search_tools`	Encontrar una herramienta por lo que quieres hacer
`describe_tool`	Leer el esquema de entrada completo de una herramienta
`read_tool`	Ejecutar una herramienta de solo lectura por nombre
`run_tool`	Ejecutar cualquier herramienta por nombre, incluidas las de escritura y las que gastan créditos

Como esta lista nunca cambia durante una conversación, la caché de prompts del cliente sigue siendo válida, lo que mantiene las sesiones largas rápidas y baratas.

Encontrar, inspeccionar, ejecutar#

Se llega a cualquier otra herramienta en tres pasos:

text

search_tools  {"query": "which prompts cite competitors but not us"}
describe_tool {"name": "seo_get_citation_gap_invisible_winners"}
read_tool     {"name": "seo_get_citation_gap_invisible_winners", "arguments": {...}}

search_tools ordena las herramientas por nombre, descripción y toolset. Funciona mejor con la pregunta en palabras llanas (“is the site down”, “customer lifetime value”) que con un nombre recordado a medias. Pasa toolset con una consulta vacía para explorar un área, y aumenta offset para recorrer una grande.
describe_tool devuelve el esquema real de argumentos y el tipo de la herramienta. Los agentes deberían llamarlo siempre antes de ejecutar una herramienta, porque algunas herramientas aceptan argumentos planos y otras un objeto query anidado.
read_tool ejecuta herramientas cuyo tipo es read: lecturas gratuitas y repetibles de tus propios datos. Rechaza cualquier otra cosa, por lo que está marcada como de solo lectura y por lo que los clientes prudentes (por ejemplo, Codex con las aprobaciones desactivadas) pueden usarla sin detenerse a preguntar.
run_tool ejecuta todo, incluidos los otros tres tipos:

Tipo	Significado
`read`	Lee los datos de tu espacio de trabajo. Gratis.
`external`	Llama a una API de terceros (Google, Bing, Meta, OpenAI, proveedores de datos) o cuesta créditos
`write`	Crea o edita datos del espacio de trabajo. Necesita el ámbito `amicited:write`
`destructive`	Elimina datos, o inicia y detiene gasto publicitario real

Una herramienta que no se anuncia no está menos protegida. Cada herramienta comprueba por sí misma los permisos, los límites del plan y los créditos, y run_tool aplica la propia comprobación de escritura de la herramienta de destino, de modo que un token de solo lectura no puede llegar a una escritura a través de ella.

Los doce toolsets#

Cada herramienta pertenece exactamente a un toolset. Los agentes los usan para decidir dónde buscar, y tú puedes usarlos para fijar un área (ver más abajo).

Toolset	Qué cubre	Herramientas de ejemplo
`domains`	Dominios, competidores y etiquetas: los ids que toman todos los demás toolsets	`list_domains`, `create_competitor`, `create_tag`
`prompts`	Prompts monitorizados y sus respuestas: crear, programar, leer respuestas, fan-outs, cobertura	`create_prompts_bulk`, `list_prompt_responses`, `prompt_query_fanouts`, `get_prompt_coverage`
`visibility`	Dónde aparece el dominio en las respuestas de IA: métricas a lo largo del tiempo, fuentes citadas, cuota de voz, mapas semánticos	`get_dashboard_metrics`, `get_prompt_detail`, `get_citations_timeseries`, `list_top_cited_domains`
`organic_search`	Google Search Console y Bing Webmaster Tools: consultas, páginas, cobertura del índice, sitemaps, envío de URL	`gsc_get_queries`, `gsc_inspect_url`, `bing_wmt_get_pages`, `indexnow_submit`
`paid_ads`	Informes de Google Ads, Microsoft Ads, Meta y LinkedIn: gasto, campañas, palabras clave, términos de búsqueda, ROAS real	`google_ppc_get_search_terms`, `bing_ppc_get_campaigns`, `meta_profit_true_roas`, `linkedin_performance`
`chatgpt_ads`	ChatGPT Ads: leer el rendimiento, y crear o editar campañas, grupos de anuncios, creatividades y seguimiento de conversiones	`ads_get_insights`, `ads_list_campaigns`, `ads_create_campaign`
`seo_reports`	Análisis orgánico construido en el almacén: movimientos, striking distance, brechas de CTR y de citas, canibalización, index bloat	`seo_get_striking_distance`, `seo_get_citation_gap_invisible_winners`, `seo_get_cannibalization_queries`
`eshop`	Analítica de ecommerce: ingresos y margen, productos, clientes, cohortes y LTV, segmentos, entradas de costes	`eshop_get_kpis`, `eshop_get_products`, `eshop_get_ltv`, `eshop_get_cost_mix`
`uptime`	Monitores, heartbeats, incidentes, informes de SLA, ventanas de mantenimiento, páginas de estado	`uptime_list_monitors`, `uptime_sla_report`, `heartbeat_create`, `status_page_create`
`content`	Artículos con IA, anotaciones y reglas de enlazado interno para una tienda conectada	`article_generate`, `annotation_create`, `link_building_list_rules`
`audits`	Salud del sitio para agentes de IA: accesibilidad para agentes, revisión de llms.txt, Web Vitals, frescura, auditoría del sitio, backlinks	`get_agent_accessibility`, `llms_txt_get_comparison`, `get_web_vitals`, `backlinks_list`
`workspace`	Plataformas de datos conectadas, estado de sincronización, importaciones y la bandeja de notificaciones	`platform_list_domain_connections`, `platform_get_sync_status`, `inbox_list_entries`

Los nombres de las herramientas llevan un prefijo por área (gsc_, bing_wmt_, google_ppc_, meta_, eshop_, uptime_, ads_), lo que facilita recorrer las transcripciones.

Fijar toolsets con `?toolsets=`#

Algunos clientes gestionan mal una llamada anidada a run_tool, y a veces quieres un agente acotado que solo vea un área. Añade un parámetro de consulta a la URL de conexión:

text

https://api.flowhunt.io/mcp/amicited?toolsets=eshop,uptime
https://api.flowhunt.io/mcp/amicited?toolsets=all

Los toolsets nombrados se anuncian entonces de forma nativa en tools/list, junto al conjunto principal. all anuncia todo, con lo que se renuncia al ahorro de contexto, así que úsalo solo con clientes que hagan su propia búsqueda de herramientas. Los nombres desconocidos se ignoran en lugar de rechazarse, así que revisa la ortografía si un área no aparece. La selección queda fijada durante toda la vida de la conexión; ninguna herramienta puede ampliarla a mitad de una conversación.

Páginas, campos y límites#

Páginas de 25 filas. Cada herramienta que devuelve una lista de filas devuelve 25 por defecto, hasta un máximo de 500 por llamada. Cuando existen más filas, la respuesta incluye un bloque paging con has_more y el valor que hay que pasar en la siguiente llamada (un offset o página nativos, o un next_cursor).
fields. Las herramientas que devuelven una única lista de filas aceptan un array fields para devolver solo las columnas que necesitas. Una columna que las filas no tienen se rechaza, no se ignora.
Sin argumento de espacio de trabajo. El espacio de trabajo lo fija tu credencial, así que ninguna herramienta acepta un id de espacio de trabajo. Casi todas las herramientas sí necesitan un domain_id de list_domains.
Tope horario. Las llamadas a herramientas se cuentan por espacio de trabajo y hora (consulta conectar). Listar herramientas y leer skills es gratuito; una herramienta oculta a la que se llega mediante read_tool o run_tool cuenta una vez.

Relacionado#

Playbook skills Qué herramientas llamar, en qué orden, para preguntas reales. Recetas Prompts que ponen a trabajar estas herramientas.