Skip to main content
Glama
veyra-webhooks

veyra-webhooks

by Aquariosan

veyra-webhooks

一个面向 AI 代理的 Webhook 中继 MCP 工具。注册目标 URL,通过 HTTP 发送负载,并浏览发送历史。读取始终免费。写入操作需要 Veyra 提交模式授权。

概述

veyra-webhooks 让 AI 代理能够通过已注册的 Webhook 端点与外部服务进行交互。历史记录持久化存储在 SQLite 中以供审计。发送负载和管理注册需要 Veyra 提交模式。

Related MCP server: agent-webhook

安装

npm install
npm run build

数据存储在 ~/.veyra-webhooks/data.db 中,首次运行时自动创建。

MCP 配置 (Claude Desktop)

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

工具

工具

输入

类

价格

list_webhooks

{}

—

免费

get_history

{ webhook_id, limit? }

—

免费

register_webhook

{ name, url, headers?, veyra_token? }

A

€0.005

send_webhook

{ webhook_id, payload, method?, veyra_token? }

B

€0.02

delete_webhook

{ webhook_id, veyra_token? }

B

€0.02

示例

读取(无需令牌)

// List all registered webhooks
{ "tool": "list_webhooks", "arguments": {} }

// View send history
{ "tool": "get_history", "arguments": { "webhook_id": "1712345678-abc1234", "limit": 20 } }

写入(需要 Veyra 令牌)

// Register a webhook
{
  "tool": "register_webhook",
  "arguments": {
    "name": "Slack Notifications",
    "url": "https://hooks.slack.com/services/...",
    "headers": "{\"Authorization\": \"Bearer token123\"}",
    "veyra_token": "vt_..."
  }
}

// Send a payload (actually fires an HTTP request)
{
  "tool": "send_webhook",
  "arguments": {
    "webhook_id": "1712345678-abc1234",
    "payload": "{\"text\": \"Deployment complete\"}",
    "method": "POST",
    "veyra_token": "vt_..."
  }
}

// Delete a webhook (also clears its history)
{
  "tool": "delete_webhook",
  "arguments": {
    "webhook_id": "1712345678-abc1234",
    "veyra_token": "vt_..."
  }
}

缺少令牌时的错误响应

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

Veyra 的工作原理

Veyra 是面向 AI 代理的提交模式授权层。当代理尝试写入时:

  1. 代理在不带 veyra_token 的情况下调用工具 → 收到包含 authorize_endpoint 的 VeyraCommitRequired 响应。

  2. 代理/用户调用授权端点以获取令牌。

  3. 代理使用设置好的 veyra_token 重试。

  4. veyra-webhooks 在执行操作前通过 @veyrahq/sdk-node 验证令牌。

请参阅 veyra.to 获取完整文档。

许可证

MIT

托管包(推荐)

建议使用托管包以实现单 URL 集成:

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

一个 URL。48 个工具。24 个免费读取。24 个受保护的写入。

托管包: https://mcp.veyra.to/sse

包清单: https://mcp.veyra.to/.well-known/veyra-pack.json

当您希望在所有 Veyra 工具系列中获得最快的 MCP 集成路径时,请使用托管包。 当您专门需要此工具独立运行时,请使用此独立包。

Veyra 生态系统的一部分

Veyra 是用于生产环境 AI 代理操作的提交模式。 所有工具:读取免费,写入需要 Veyra 提交模式。

工具

描述

安装

veyra-memory

键值存储

npm i -g veyra-memory

veyra-notes

带标签的笔记记录

npm i -g veyra-notes

veyra-tasks

任务管理

npm i -g veyra-tasks

veyra-snippets

代码片段存储

npm i -g veyra-snippets

veyra-bookmarks

书签管理器

npm i -g veyra-bookmarks

veyra-contacts

联系人管理

npm i -g veyra-contacts

veyra-forms

表单构建器

npm i -g veyra-forms

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

Related MCP Connectors

Related MCP Servers