agency-mcp-server

Una entrada de configuración MCP. Más de 150 agentes especializados 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 al agente adecuado y lo crea.

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

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

¿Por qué no instalar los 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 hemos medido:

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

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 nueva sesión de Claude Code y ejecutamos /context. Claude Code informó "Custom agents: 8.3k tokens", cargados en cada conversación independientemente de 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 cargan datos de agentes.

MCP buscando (350 tokens): Medido mediante la tokenización de 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 de tokens mediano en los 145 archivos de agentes, medido con @anthropic-ai/tokenizer. Solo el archivo del agente que realmente estás usando se carga en el contexto. El rango es de 383 a 12,724 tokens dependiendo del 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 vía 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 en ~/.cache/agency-mcp-server/ y busca actualizaciones cada 24 horas.

Verifica que funciona

Pregúntale a tu asistente:

"Search for a game economy designer agent"

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:

1. agency_search(query, division?) -- describe una tarea, obtén agentes coincidentes con instrucciones de creación

2. agency_browse(division?) -- explora divisiones y agentes cuando quieras ver qué hay disponible

3. agency_status() -- verifica la frescura del índice: recuento de agentes, hora de la última actualización, si hay una actualización disponible

4. agency_update() -- obtén 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 crea 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:

Configuración

Toda la configuración se realiza a través de variables de entorno en tu configuración MCP:

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 en Markdown se convierte en el prompt del sistema del agente cuando se crea.

Interfaz MCP

Herramientas

• agency_search(query, division?) -- encuentra agentes por descripción de tarea, devuelve coincidencias con rutas de archivo y una plantilla de creación lista para usar

• agency_browse(division?) -- enumera todas las divisiones, o enumera agentes dentro de una división específica

• agency_status() -- verifica la frescura del índice: recuento de agentes, hora de la última actualización, si hay una actualización pendiente

• agency_update() -- obtén 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 creación

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