Skip to main content
Glama
Trigv
by Trigv

@trigv/mcp

MCP (Model Context Protocol) server for Trigv. Lets AI clients in Cursor, Claude Code, and VS Code send notification events to your Trigv workspace.

What Trigv is

Trigv delivers developer notifications to your team's devices. Your backend (or AI agent) sends lightweight JSON events; Trigv queues push delivery. Notification title and body are not stored on Trigv servers — metadata only.

Related MCP server: SuprSend MCP Server

Installation

npm install @trigv/mcp

Or run directly with npx:

npx @trigv/mcp

Quick start

  1. Create a workspace API key at app.trigv.com.

  2. Set TRIGV_API_KEY in your MCP client config (see below).

  3. Ask your AI assistant to send an event using the send_event tool.

Example tool call:

{
  "channel": "deploys",
  "title": "Production deploy complete",
  "description": "Build #42 succeeded in 38s (commit abc1234)",
  "level": "success",
  "event_type": "deploy.completed",
  "idempotency_key": "deploy-prod-42"
}

Authentication

Variable

Required

Default

Description

TRIGV_API_KEY

Yes

Workspace ingest API key (trgv_…)

TRIGV_BASE_URL

No

https://api.trigv.com/api

Override for local dev (http://trigv-platform.test/api)

The API key is sent as Authorization: Bearer and is never included in tool responses or error messages.

Tool: send_event

Sends a notification event via POST /v1/events.

Field

Required

Description

channel

Yes

Channel slug (e.g. general, deploys)

title

Yes

Notification title

description

No

Body text

image_url

No

HTTPS image URL (not stored server-side)

url

No

Destination URL for the notification (max 2048 characters; not stored server-side)

level

No

info, success, warning, error (default: info)

delivery_urgency

No

standard or time_sensitive (default: standard)

event_type

No

Free-form label (e.g. deploy.completed)

idempotency_key

No

Dedup key per workspace

Success response includes event.public_id, duplicate (true when HTTP 200), and other event metadata.

Error response includes error.type, error.message, and optional error.errors for validation failures.

Levels

  • info — general information (default)

  • success — completed successfully

  • warning — attention needed

  • error — failure or alert

Delivery urgency

  • standard — normal notifications (default)

  • time_sensitive — iOS Time Sensitive delivery

Idempotency

When you set idempotency_key, retries with the same key return the existing event (duplicate: true) without billing again.

Error handling

Error type

When

ConfigurationError

Missing TRIGV_API_KEY

ValidationError

Invalid input (client or server 422)

AuthenticationError

HTTP 401

AuthorizationError

HTTP 403

NotFoundError

Channel not found (HTTP 404)

RateLimitError

HTTP 429

NetworkError / TimeoutError

Connection issues

MCP client configuration

Cursor

Add to .cursor/mcp.json in your project (or global Cursor MCP settings):

{
  "mcpServers": {
    "trigv": {
      "command": "npx",
      "args": ["-y", "@trigv/mcp"],
      "env": {
        "TRIGV_API_KEY": "trgv_your_api_key_here"
      }
    }
  }
}

For a local checkout during development:

{
  "mcpServers": {
    "trigv": {
      "command": "node",
      "args": ["/path/to/trigv-mcp/dist/index.js"],
      "env": {
        "TRIGV_API_KEY": "trgv_your_api_key_here",
        "TRIGV_BASE_URL": "http://trigv-platform.test/api"
      }
    }
  }
}

Claude Code

Add to ~/.claude/settings.json or project .claude/settings.json:

{
  "mcpServers": {
    "trigv": {
      "command": "npx",
      "args": ["-y", "@trigv/mcp"],
      "env": {
        "TRIGV_API_KEY": "trgv_your_api_key_here"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "trigv": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@trigv/mcp"],
      "env": {
        "TRIGV_API_KEY": "trgv_your_api_key_here"
      }
    }
  }
}

Examples

Basic event

{ "channel": "general", "title": "Hello from MCP" }

Deploy completed (canonical)

{
  "channel": "deploys",
  "title": "Production deploy complete",
  "description": "Build #42 succeeded in 38s (commit abc1234)",
  "level": "success",
  "delivery_urgency": "standard",
  "event_type": "deploy.completed",
  "idempotency_key": "deploy-prod-42"
}

Cron job failed

{
  "channel": "alerts",
  "title": "Nightly backup failed",
  "description": "Exit code 1 after 12 minutes",
  "level": "error",
  "event_type": "cron.failed"
}

Development

git clone https://github.com/Trigv/trigv-mcp.git
cd trigv-mcp
npm install
npm run build
npm test

Run locally:

TRIGV_API_KEY=trgv_… npm run dev

Testing

npm test

Tests use mocked HTTP — no live API key required in CI.

Contributing

See the Trigv SDK programme for API contract and conformance requirements.

Licence

MIT — see LICENSE.

Available Tools

1 tool
send_eventA

Send a notification event to a Trigv workspace channel. Requires TRIGV_API_KEY.

ParametersJSON Schema
NameRequiredDescriptionDefault
levelNoNotification level (default: info)
titleYesNotification title
channelYesChannel slug (e.g. general, deploys)
image_urlNoOptional HTTPS image URL (not stored server-side)
event_typeNoFree-form event label (e.g. deploy.completed)
descriptionNoOptional body text (not stored server-side)
idempotency_keyNoDedup key per workspace; retries return the existing event
delivery_urgencyNoDelivery urgency (default: standard)

Output Schema

ParametersJSON Schema
NameRequiredDescription
errorNo
eventNo
successYes
duplicateNo

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description discloses the auth requirement (TRIGV_API_KEY), which is important. However, it does not mention other behavioral traits such as idempotency (hinted at in schema), side effects, or whether the call is safe or mutating. With no annotations, the description could provide more context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that effectively conveys the core action and a critical requirement. No unnecessary words; it is appropriately concise and front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has 8 parameters (some with enums) and an output schema, the description is minimal. It covers the essential purpose but does not provide additional context on when to include optional parameters or typical usage patterns. The presence of an output schema mitigates the need to explain return values.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description adds no extra meaning beyond 'Send a notification event to a Trigv workspace channel'—it does not elaborate on any parameters or their roles, so it meets but does not exceed the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb 'Send', the resource 'notification event', and the destination 'Trigv workspace channel'. It explicitly distinguishes the tool's purpose despite no siblings, and the required API key adds context. No ambiguity.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for sending notifications to a workspace channel and mentions a prerequisite (API key). However, it does not explicitly state when to use this tool versus alternatives or provide exclusion criteria, though the context of sending events is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev0.1.0
    • First observedsend_event

TDQS

A3.9/5.0
Disambiguation5/5

Only one tool exists, so there is no ambiguity. The single tool has a clear, distinct purpose.

Naming Consistency5/5

With only one tool, naming consistency is perfect as there are no other tools to conflict with. The name 'send_event' follows a clear verb_noun pattern.

Tool Count3/5

A single tool is borderline; while it may be sufficient for a very narrow purpose, it feels thin compared to the typical 3-15 tools for a well-scoped server.

Completeness2/5

The server only provides a send operation, missing other expected capabilities like event listing, deletion, or configuration, which limits its usefulness for agents.

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Provides automatic desktop notifications and contextual sounds for Claude Code operations across macOS, Windows, and Linux. It enhances the development experience by intelligently mapping specific event types to native system alerts and sounds.
    4
    11
    3
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Manage your entire notification infrastructure using natural language. Trigger workflows, create users, manage preferences, update tenant branding, and access docs — all from Cursor, Claude Desktop, or Windsurf. 24 tools covering email, SMS, push, WhatsApp, Slack, MS Teams, and in-app notifications.
    22
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Connects VS Code Copilot to Telegram for mobile notifications, interactive approval workflows, and remote command input. Enables users to monitor AI agents, approve sensitive operations, and provide follow-up instructions from their smartphone.
    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/Trigv/trigv-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server