agency-mcp-server

Acceso bajo demanda a más de 150 plantillas de agentes de IA especializados: busca, explora y genera agentes. Reducción de 150 veces en el uso de contexto en comparación con cargar agentes localmente.

GitHub

Prueba este MCPPatrocinado

Documentación

agency-mcp-server

Una entrada de configuración MCP. Más de 150 agentes especialistas bajo demanda. Sin configuración manual.

Tu asistente de IA es un generalista. A veces necesitas un especialista: un diseñador de economía de juegos, un auditor de seguridad, un redactor técnico. Este servidor MCP le da a tu asistente acceso instantáneo a más de 150 plantillas de agentes expertos. Describe lo que necesitas, encuentra el agente adecuado y lo lanza.

You: "Help me design a balanced game economy"
Claude: [searches -> finds Game Economy Designer -> spawns it -> expert response]

Las plantillas se descargan automáticamente en la primera ejecución desde agency-agents y se mantienen actualizadas. No tienes que tocar nada.

¿Por qué no simplemente instalar agentes localmente?

Puedes hacerlo. El script de instalación de agency-agents copia los más de 160 archivos de agentes directamente en el directorio de configuración de tu herramienta (por ejemplo, ~/.claude/agents/). Funciona, pero el nombre y la descripción de cada agente se cargan en la ventana de contexto de cada conversación, los uses o no.

Lo medimos:

Enfoque	Costo de contexto	Cuándo
Agentes instalados (`~/.claude/agents/`)	~8,300 tokens	Cada conversación, siempre
Servidor MCP (inactivo)	~55 tokens	Cada conversación
Servidor MCP (buscando)	~350 tokens	Solo cuando buscas
Servidor MCP (usando un agente)	~2,700 tokens	Solo cuando lanzas uno (mediana)

Eso es una reducción de 150x en el uso de contexto base. Obtienes los mismos 160+ agentes, pero solo pagas por el que realmente estás usando.

Cómo medimos esto

Agentes instalados (8,300 tokens): Ejecutamos el script de instalación de agency-agents (install.sh --tool claude-code), que copió 162 archivos de agentes a ~/.claude/agents/. Luego abrimos una sesión nueva de Claude Code y ejecutamos /context. Claude Code informó "Custom agents: 8.3k tokens" -- cargado en cada conversación sin importar si se usa algún agente.

MCP inactivo (55 tokens): Con el servidor MCP configurado en su lugar, /context muestra solo los dos nombres de herramientas diferidas (agency_search, agency_browse) y una breve descripción del servidor en el prompt del sistema. No se carga ningún dato de agente.

MCP buscando (350 tokens): Medido tokenizando los esquemas JSON completos de las herramientas que se cargan cuando el asistente llama a ToolSearch para resolver las herramientas agency_search y agency_browse. Contado con @anthropic-ai/tokenizer.

MCP usando un agente (2,700 tokens): El recuento mediano de tokens en los 145 archivos de agentes, medido con @anthropic-ai/tokenizer. Solo se carga en el contexto el archivo del agente que realmente estás usando. El rango es de 383 a 12,724 tokens según el agente (p25: 1,549, p75: 3,584).

Inicio Rápido

Claude Code

Como plugin:

/plugin marketplace add npupko/agency-mcp-server
/plugin install agency@agency-mcp-server

O mediante CLI:

claude mcp add agency -- npx -y agency-mcp-server

Cursor, Windsurf y otros clientes MCP

Añade a tu configuración MCP:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"]
    }
  }
}

Eso es todo. El primer lanzamiento clona las plantillas a ~/.cache/agency-mcp-server/ y descarga actualizaciones cada 24 horas.

Verifica que funciona

Pregunta a tu asistente:

"Busca un agente diseñador de economía de juegos"

Deberías ver resultados de la herramienta agency_search. Si es la primera ejecución, las plantillas se descargarán automáticamente (~30 segundos).

Cómo Funciona

Tu asistente obtiene cuatro herramientas:

agency_search(query, division?) -- describe una tarea, obtén agentes coincidentes con instrucciones de lanzamiento
agency_browse(division?) -- explora divisiones y agentes cuando quieras ver qué hay disponible
agency_status() -- comprueba la frescura del índice: número de agentes, hora de la última actualización, si hay una actualización disponible
agency_update() -- descarga las últimas plantillas de git y reconstruye el índice de búsqueda sin reiniciar

Cuando pides ayuda con algo específico, tu asistente llama a agency_search, elige la mejor coincidencia y lanza un subagente con el prompt del sistema completo de ese especialista. Obtienes una respuesta experta sin tocar nunca un archivo de configuración.

Qué hay disponible

Los agentes están organizados en divisiones:

División	Ejemplos
Ingeniería	Software Architect, DevOps Engineer, Technical Writer
Diseño	UI Designer, UX Researcher, Design Systems
Desarrollo de Juegos	Game Economy Designer, Game Mechanics Designer
Marketing	Content Strategist, SEO Specialist, Email Marketing
Seguridad y Especializados	Security Auditor, Data Scientist, Legal Analyst
...y más	Academic, Sales, Strategy, Support, Testing, Spatial Computing

Configuración

Toda la configuración se realiza mediante variables de entorno en tu configuración MCP:

Variable	Por defecto	Descripción
`AGENCY_AGENTS_PATH`	`~/.cache/agency-mcp-server/agency-agents`	Ruta a las plantillas de agentes. Establece esto para usar tus propias plantillas en lugar de la clonación automática
`AGENCY_REPO_URL`	`https://github.com/msitarzewski/agency-agents.git`	Repositorio Git del que clonar las plantillas. Apunta a tu fork
`AGENCY_AUTO_UPDATE`	`true`	Establece a `false` para desactivar las descargas automáticas
`AGENCY_UPDATE_INTERVAL`	`24`	Horas entre comprobaciones de actualización

Usa tus propias plantillas

Apunta a un directorio local:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"],
      "env": {
        "AGENCY_AGENTS_PATH": "/path/to/your/agent-templates"
      }
    }
  }
}

O clona desde tu propio repositorio:

{
  "mcpServers": {
    "agency": {
      "command": "npx",
      "args": ["-y", "agency-mcp-server"],
      "env": {
        "AGENCY_REPO_URL": "https://github.com/yourorg/custom-agents.git"
      }
    }
  }
}

Formato de plantilla

Cada agente es un archivo Markdown con front-matter YAML, organizado por división:

engineering/
  software-architect.md
  devops-engineer.md
design/
  ui-designer.md
game-development/
  game-economy-designer.md

---
name: Software Architect
description: Expert software architect specializing in system design...
---

Full agent system prompt goes here.

El servidor indexa los campos name y description para la búsqueda. El cuerpo completo de Markdown se convierte en el prompt del sistema del agente cuando se lanza.

Interfaz MCP

Herramientas

agency_search(query, division?) -- encuentra agentes por descripción de tarea, devuelve coincidencias con rutas de archivo y una plantilla de lanzamiento lista para usar
agency_browse(division?) -- lista todas las divisiones, o lista agentes dentro de una división específica
agency_status() -- comprueba la frescura del índice: número de agentes, hora de la última actualización, si hay una actualización pendiente
agency_update() -- descarga las últimas plantillas de git y reconstruye el índice de búsqueda en tiempo de ejecución

Recursos

agency://agents -- índice completo de agentes como JSON
agency://divisions -- lista de divisiones con recuentos y ejemplos

Prompts

use-agent -- describe una tarea, obtén el agente que mejor coincida con instrucciones de lanzamiento

Desarrollo

npm install
npm run build

# Run with auto-fetched templates
node dist/index.js

# Run with local templates
AGENCY_AGENTS_PATH=./my-agents node dist/index.js

# Type checking
npm run typecheck

# MCP Inspector
npm run inspect

Créditos

Plantillas de agentes de agency-agents por @msitarzewski.

Licencia

MIT