veyra-contacts
veyra-contacts
Ein MCP-Tool zur Kontaktverwaltung für KI-Agenten. Speichern und abfragen von Namen, E-Mails, Telefonnummern und Unternehmen. Kontaktdaten sind geschäftskritisch – alle Schreibvorgänge sind Klasse B und erfordern eine Autorisierung über den Veyra-Commit-Modus.
Übersicht
veyra-contacts stellt KI-Agenten eine persistente Kontaktdatenbank auf Basis von SQLite zur Verfügung. Lesezugriffe sind kostenlos. Alle Änderungen (Erstellen, Aktualisieren, Löschen) sind Klasse B (€0,02), da Kontaktdaten geschäftskritisch sind und vor versehentlichen Schreibvorgängen geschützt werden müssen.
Related MCP server: veyra-forms
Installation
npm install
npm run buildDie Daten werden unter ~/.veyra-contacts/data.db gespeichert und beim ersten Start automatisch erstellt.
MCP-Konfiguration (Claude Desktop)
{
"mcpServers": {
"veyra-contacts": {
"command": "node",
"args": ["/absolute/path/to/veyra-contacts/dist/index.js"]
}
}
}Tools
Tool | Eingabe | Klasse | Preis |
|
| — | KOSTENLOS |
|
| — | KOSTENLOS |
|
| — | KOSTENLOS |
|
| B | €0,02 |
|
| B | €0,02 |
|
| B | €0,02 |
Alle Schreibvorgänge sind Klasse B, da Kontaktdaten geschäftskritisch sind.
Beispiele
Lesen (kein Token erforderlich)
// List all contacts
{ "tool": "list_contacts", "arguments": {} }
// Filter by company
{ "tool": "list_contacts", "arguments": { "company": "Acme Corp" } }
// Search across name, email, company, tags
{ "tool": "search_contacts", "arguments": { "query": "alice" } }
// Get a specific contact
{ "tool": "get_contact", "arguments": { "id": "1712345678-abc1234" } }Schreiben (Veyra-Token erforderlich – Klasse B)
// Create a contact
{
"tool": "create_contact",
"arguments": {
"name": "Alice Müller",
"email": "alice@example.com",
"phone": "+49 123 456789",
"company": "Acme Corp",
"tags": "customer,vip",
"veyra_token": "vt_..."
}
}
// Update a contact
{
"tool": "update_contact",
"arguments": {
"id": "1712345678-abc1234",
"email": "alice.new@example.com",
"veyra_token": "vt_..."
}
}
// Delete a contact
{
"tool": "delete_contact",
"arguments": { "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 Autorisierungsebene für den Commit-Modus bei KI-Agenten. Wenn ein Agent einen Schreibvorgang versucht:
Der Agent ruft das Tool ohne
veyra_tokenauf → erhältVeyraCommitRequiredmitauthorize_endpoint.Der Agent/Benutzer ruft den Autorisierungs-Endpunkt auf, um ein Token zu erhalten.
Der Agent wiederholt den Vorgang mit gesetztem
veyra_token.veyra-contactsverifiziert das Token über@veyrahq/sdk-node, bevor die Aktion ausgeführt wird.
Siehe veyra.to für die vollständige Dokumentation.
Lizenz
MIT
Gehostetes Paket (empfohlen)
Bevorzugen Sie das gehostete Paket für eine Ein-URL-Integration:
{
"mcpServers": {
"veyra": {
"url": "https://mcp.veyra.to/sse"
}
}
}Eine URL. 48 Tools. 24 kostenlose Lesezugriffe. 24 geschützte Schreibzugriffe.
Gehostetes Paket: https://mcp.veyra.to/sse
Paket-Manifest: https://mcp.veyra.to/.well-known/veyra-pack.json
Verwenden Sie das gehostete Paket, 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.
Tool | Beschreibung | Installation |
Key-Value-Speicher |
| |
Notizen mit Tags |
| |
Aufgabenverwaltung |
| |
Code-Snippet-Speicher |
| |
Lesezeichen-Manager |
| |
Formular-Builder |
| |
Webhook-Sender |
|
SDK: npm install @veyrahq/sdk-node Website: veyra.to
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Free contact network for AI agents and people. Find, verify, and message anyone.
Personal CRM operated by AI agents. Read relationship context before acting, write back after.
ppl personal CRM: contacts, relationship notes, birthdays and follow-ups for AI agents. Hosted MCP.
B2B contact database for AI agents: search, count, export and enrich 375M+ contacts.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceNote-taking MCP server for AI agents with tags and full-text search. Reads are free, writes require Veyra commit mode.MIT
- AlicenseNot gradedqualityDmaintenanceForm builder and response collector for AI agents. Reads are free, writes require Veyra commit mode.MIT
- AlicenseNot gradedqualityDmaintenanceBookmark manager for AI agents with tags, categories, and full-text search. Reads are free, writes require Veyra commit mode.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage contacts with full CRUD, dedup, merge, import/export, sync with Google/Apple/CardDAV, and git-backed rollback.AGPL 3.0