Skip to main content
Glama

agentcast-mcp

npm tests mcp

Un servidor MCP que ofrece a los asistentes de IA la capacidad de imponer una salida estructurada: extraer JSON de texto desordenado de un LLM, validarlo contra una especificación de forma y producir el mensaje de retroalimentación de reintento cuando el modelo devuelve una forma incorrecta.

Construido sobre @mukundakatta/agentcast. Funciona con Claude Desktop, Cursor, Cline, Windsurf, Zed y cualquier otro cliente MCP.

Herramientas expuestas

extract_json

Extrae un valor JSON de una salida desordenada de un LLM. Prueba con todo el texto, luego con un bloque ```json ``` delimitado y, finalmente, con la subcadena {...} / [...] equilibrada más grande. Devuelve el valor analizado y la estrategia que tuvo éxito.

{
  "text": "Sure, here you go:\n```json\n{\"answer\": 42}\n```\nLet me know!"
}

→

{
  "value": { "answer": 42 },
  "found": true,
  "source": "fenced_json"
}

source es uno de los siguientes: whole, fenced_json, fenced_plain, balanced_substring o none.

validate_response

Valida un valor JSON analizado contra una especificación de forma de agentcast. La especificación asigna el nombre del campo al tipo: string, number, boolean, array, object. Añade ? al final para indicar que es opcional.

{
  "value": { "name": "ada" },
  "shape": { "name": "string", "age": "number" }
}

→

{
  "valid": false,
  "error": "missing required field 'age'"
}

build_retry_prompt

Dada un historial de intentos, produce el mensaje de retroalimentación de error de validación que agentcast añade a la conversación cuando el modelo devuelve una forma incorrecta. Codifica el patrón de "error de validación como retroalimentación" para clientes MCP que no son de Node y que desean ejecutar el mismo bucle de reintento manualmente.

{
  "attempts": [
    { "text": "{\"name\":\"ada\"}", "error": "missing required field 'age'" }
  ],
  "expected_shape": { "name": "string", "age": "number" }
}

→

{
  "feedback": "Your previous response did not match the required shape. Error: missing required field 'age'\n\nTry again. Respond with ONLY valid JSON that fixes the error above.\n\nExpected shape: {\"name\":\"string\",\"age\":\"number\"}"
}

Related MCP server: genpark-structured-extract-schema-validator-skill

Instalación

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "agentcast": {
      "command": "npx",
      "args": ["-y", "@mukundakatta/agentcast-mcp"]
    }
  }
}

Cursor / Cline / Windsurf / Zed

La misma estructura, en el archivo mcp.json apropiado para su cliente. La mayoría de los clientes lo detectan automáticamente mediante npx -y @mukundakatta/agentcast-mcp.

Instalación local

npm install -g @mukundakatta/agentcast-mcp
mcp-agentcast        # listens on stdio

Por qué es importante

Cuando se supone que un LLM debe devolver datos estructurados, a veces envuelve el JSON en prosa, delimitadores o campos alucinados. El JSON.parse estándar lanza un error. Las expresiones regulares creadas manualmente no detectan estructuras anidadas. Este servidor MCP proporciona a cualquier modelo que controle un agente una forma real de (1) extraer JSON de la respuesta, (2) comprobar que coincide con la forma esperada y (3) construir el aviso de reintento exacto que empuja al modelo a corregirlo en el siguiente turno.

Licencia

MIT.

Available Tools

3 tools
build_retry_promptA

Given an attempt history, produce the retry feedback message agentcast would append to the conversation when the model returned the wrong shape. Codifies the "validation error as feedback" pattern for non-Node MCP clients.

Inputs: attempts (required), expected_shape.

extract_jsonA

Pull a JSON value out of messy LLM output. Tries the whole text, then a fenced json block, then the largest balanced {...}/[...] substring. Returns the parsed value plus which strategy succeeded.

Inputs: text (required).

validate_responseA

Validate a parsed JSON value against an agentcast shape spec. Spec maps field name to type: 'string', 'number', 'boolean', 'array', 'object'. Suffix with '?' for optional. Returns valid=true on success, or valid=false with a human-readable error string suitable for retry feedback.

Inputs: shape (required), value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: build_retry_prompt handles feedback generation, extract_json extracts JSON from text, and validate_response checks JSON against a spec. There is no functional overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (build_retry_prompt, extract_json, validate_response), making them predictable and easy to understand.

    Tool Count4/5

    With only 3 tools, the server is slightly underpopulated but still appropriately scoped for the narrow domain of agent response validation and retry feedback. It covers the core workflow without unnecessary bloat.

    Completeness4/5

    The tools cover the essential pipeline of extracting JSON, validating it against a spec, and generating retry feedback. A minor gap is the lack of explicit handling of attempt history beyond what build_retry_prompt expects, but that is assumed provided by the client.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Deterministic JSON validation and repair for AI agents. Validates, repairs, schema-checks, and diffs JSON so long-running agents don't corrupt their session state with malformed writes.
      MIT