veyra-webhooks
veyra-webhooks
一个用于 AI 代理的 Webhook 中继 MCP 工具。注册目标 URL，通过 HTTP 发送负载，并浏览发送历史。读取操作始终免费。写入操作需要 Veyra 提交模式授权。
概述
veyra-webhooks 让 AI 代理能够通过已注册的 Webhook 端点与外部服务进行交互。历史记录持久化存储在 SQLite 中以供审计。发送负载和管理注册需要 Veyra 提交模式。
安装
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"]
}
}
}工具
工具 | 输入 | 类 | 价格 |
|
| — | 免费 |
|
| — | 免费 |
|
| A | €0.005 |
|
| B | €0.02 |
|
| 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 代理的提交模式授权层。当代理尝试执行写入操作时：
代理在不带
veyra_token的情况下调用工具 → 收到包含authorize_endpoint的VeyraCommitRequired错误。代理/用户调用授权端点以获取令牌。
代理使用设置好的
veyra_token重试。veyra-webhooks在执行操作前通过@veyrahq/sdk-node验证令牌。
请参阅 veyra.to 获取完整文档。
许可证
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Aquariosan/veyra-webhooks'
If you have feedback or need assistance with the MCP directory API, please join our Discord server