veyra-forms

Ein MCP-Tool zum Erstellen von Formularen und Umfragen für KI-Agenten. Definieren Sie Formulare mit typisierten Feldern, sammeln Sie strukturierte Antworten und fragen Sie Ergebnisse ab. Lesezugriffe sind immer kostenlos. Schreibvorgänge erfordern eine Autorisierung im Veyra-Commit-Modus.

Übersicht

veyra-forms ermöglicht es KI-Agenten, programmgesteuert Formulare zu erstellen, Antworten zu übermitteln und Ergebnisse zu lesen – alles basierend auf SQLite. Die Erstellung von Formularen und die Übermittlung von Antworten sind Operationen der Klasse B.

Related MCP server: humansurvey-mcp

Installation

npm install
npm run build

Die Daten werden unter ~/.veyra-forms/data.db gespeichert und beim ersten Start automatisch erstellt.

MCP-Konfiguration (Claude Desktop)

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

Tools

Feldtypen

Jeder String wird als type akzeptiert. Gängige Werte: text, email, number, boolean, date, textarea.

Beispiele

Lesen (kein Token erforderlich)

// 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" } }

Schreiben (Veyra-Token erforderlich)

// 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_..." }
}

Fehlerantwort bei fehlendem 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"
}

Funktionsweise von Veyra

Veyra ist eine Autorisierungsschicht im Commit-Modus für KI-Agenten. Wenn ein Agent einen Schreibvorgang versucht:

1. Der Agent ruft das Tool ohne veyra_token auf → erhält VeyraCommitRequired mit authorize_endpoint.

2. Der Agent/Benutzer ruft den Autorisierungs-Endpunkt auf, um ein Token zu erhalten.

3. Der Agent wiederholt den Vorgang mit gesetztem veyra_token.

4. veyra-forms verifiziert das Token über @veyrahq/sdk-node, bevor die Aktion ausgeführt wird.

Siehe veyra.to für die vollständige Dokumentation.

Lizenz

MIT

Hosted Pack (empfohlen)

Bevorzugen Sie das Hosted Pack für eine Integration über eine einzige URL:

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

Eine URL. 48 Tools. 24 kostenlose Lesezugriffe. 24 geschützte Schreibzugriffe.

Hosted Pack: https://mcp.veyra.to/sse

Pack-Manifest: https://mcp.veyra.to/.well-known/veyra-pack.json

Verwenden Sie das Hosted Pack, wenn Sie den schnellsten MCP-Integrationspfad für alle Veyra-Tool-Familien wünschen. Verwenden Sie dieses eigenständige Paket, wenn Sie dieses Tool speziell für sich allein benötigen.

Teil des Veyra-Ökosystems

Veyra ist der Commit-Modus für produktive KI-Agenten-Aktionen. Alle Tools: Lesezugriffe kostenlos, Schreibzugriffe erfordern den Veyra-Commit-Modus.

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