veyra-forms

Una herramienta MCP de creación de formularios y encuestas para agentes de IA. Define formularios con campos tipados, recopila respuestas estructuradas y consulta resultados. Las lecturas son siempre gratuitas. Las operaciones de escritura requieren autorización del modo de confirmación de Veyra.

Descripción general

veyra-forms permite a los agentes de IA crear formularios, enviar respuestas y leer resultados mediante programación, todo respaldado por SQLite. La creación de formularios y el envío de respuestas son operaciones de Clase B.

Related MCP server: humansurvey-mcp

Instalación

npm install
npm run build

Los datos se almacenan en ~/.veyra-forms/data.db, creado automáticamente en la primera ejecución.

Configuración de MCP (Claude Desktop)

{
  "mcpServers": {
    "veyra-forms": {
      "command": "node",
      "args": ["/absolute/path/to/veyra-forms/dist/index.js"]
    }
  }
}

Herramientas

Tipos de campo

Se acepta cualquier cadena como type. Valores comunes: text, email, number, boolean, date, textarea.

Ejemplos

Lectura (no se necesita token)

// List all forms
{ "tool": "list_forms", "arguments": {} }

// Get a form and its field schema
{ "tool": "get_form", "arguments": { "form_id": "1712345678-abc1234" } }

// Get all responses for a form
{ "tool": "get_responses", "arguments": { "form_id": "1712345678-abc1234" } }

Escritura (se requiere token de Veyra)

// Create a form
{
  "tool": "create_form",
  "arguments": {
    "title": "Customer Feedback",
    "fields": [
      { "name": "name", "type": "text", "required": true },
      { "name": "email", "type": "email", "required": true },
      { "name": "rating", "type": "number", "required": true },
      { "name": "comment", "type": "textarea" }
    ],
    "veyra_token": "vt_..."
  }
}

// Submit a response
{
  "tool": "submit_response",
  "arguments": {
    "form_id": "1712345678-abc1234",
    "data": {
      "name": "Alice",
      "email": "alice@example.com",
      "rating": 5,
      "comment": "Excellent service!"
    },
    "veyra_token": "vt_..."
  }
}

// Delete a form (also deletes all responses)
{
  "tool": "delete_form",
  "arguments": { "form_id": "1712345678-abc1234", "veyra_token": "vt_..." }
}

Respuesta de error cuando falta el token

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "authorize_endpoint": "https://api.veyra.to/v1/authorize-action",
  "docs_url": "https://veyra.to"
}

Cómo funciona Veyra

Veyra es una capa de autorización de modo de confirmación para agentes de IA. Cuando un agente intenta una escritura:

1. El agente llama a la herramienta sin veyra_token → recibe VeyraCommitRequired con authorize_endpoint.

2. El agente/usuario llama al endpoint de autorización para obtener un token.

3. El agente vuelve a intentarlo con veyra_token configurado.

4. veyra-forms verifica el token a través de @veyrahq/sdk-node antes de ejecutar la acción.

Consulta veyra.to para obtener la documentación completa.

Licencia

MIT

Paquete alojado (recomendado)

Prefiere el paquete alojado para una integración de una sola URL:

{
  "mcpServers": {
    "veyra": {
      "url": "https://mcp.veyra.to/sse"
    }
  }
}

Una URL. 48 herramientas. 24 lecturas gratuitas. 24 escrituras protegidas.

Paquete alojado: https://mcp.veyra.to/sse

Manifiesto del paquete: https://mcp.veyra.to/.well-known/veyra-pack.json

Utiliza el paquete alojado cuando desees la ruta de integración MCP más rápida en todas las familias de herramientas de Veyra. Utiliza este paquete independiente cuando desees específicamente esta herramienta por sí sola.

Parte del ecosistema Veyra

Veyra es el modo de confirmación para acciones de agentes de IA en producción. Todas las herramientas: lecturas gratuitas, escrituras requieren el modo de confirmación de Veyra.

SDK: npm install @veyrahq/sdk-node Sitio web: veyra.to