Skip to main content
Glama
mesheshq

@mesheshq/mcp-server

Official
by mesheshq
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@mesheshq/mcp-server

Tests NPM Version NPM Install Size

MCP server for Meshes — emit events, manage workspaces, create routing rules, and inspect deliveries from any MCP-compatible client.

Features

  • Emit Events — send product events (signups, payments, cancellations) to Meshes

  • Manage Workspaces — list and configure workspaces

  • Workspace Discovery — inspect available workspace event types and resources

  • Routing Rules — create and update event routing rules

  • Connections — manage integration connections (HubSpot, Salesforce, Slack, Mailchimp, etc.)

  • Delivery Status — inspect event delivery logs and retry status

  • Embedded Sessions — mint, list, refresh, and revoke workspace, dashboard, or resource-scoped sessions

Related MCP server: Segment Workspace MCP Server

Setup

Create a free Meshes account and create Machine Keys in the dashboard under Profile → API Keys.

Claude Code

claude mcp add meshes \
 -e MESHES_ACCESS_KEY=your_access_key \
 -e MESHES_SECRET_KEY=your_secret_key \
 -e MESHES_ORG_ID=your_org_id \
 -- npx -y @mesheshq/mcp-server

Cursor

Open Cursor Settings → MCP → Add new global MCP server:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "meshes": {
      "command": "npx",
      "args": ["-y", "@mesheshq/mcp-server"],
      "env": {
        "MESHES_ACCESS_KEY": "your_access_key",
        "MESHES_SECRET_KEY": "your_secret_key",
        "MESHES_ORG_ID": "your_organization_uuid"
      }
    }
  }
}

Security note: MCP config files contain your secret key. They live in your home directory (e.g. ~/.cursor/mcp.json), not your project repo. Never commit access keys or secret keys to version control.

Environment Variables

Variable

Required

Description

MESHES_ACCESS_KEY

Yes

Machine access key from dashboard

MESHES_SECRET_KEY

Yes

Machine secret key from dashboard

MESHES_ORG_ID

Yes*

Organization UUID

MESHES_ORGANIZATION_ID

Yes*

Alias for MESHES_ORG_ID (SDK-compatible name)

MESHES_API_URL

No

API base URL (default: https://api.meshes.io)

* Set either MESHES_ORG_ID or MESHES_ORGANIZATION_ID.

Available Tools

Tool

Description

meshes_emit_event

Emit a product event to Meshes for routing and delivery

meshes_emit_bulk_events

Emit up to 100 events in a single request

meshes_list_workspaces

List all workspaces in the multi-tenant organization

meshes_get_workspace

Get details of a specific workspace

meshes_create_workspace

Create a new workspace

meshes_update_workspace

Update workspace properties

meshes_get_workspace_connections

List connections scoped to a workspace

meshes_get_workspace_event_types

List event types configured for a workspace

meshes_get_workspace_resources

List resources configured for a workspace

meshes_get_workspace_rules

List workspace rules with optional event/resource filters

meshes_list_connections

List connections across the organization

meshes_get_connection

Get details of a connection

meshes_create_connection

Create a new connection destination

meshes_update_connection

Update connection configuration metadata

meshes_delete_connection

Delete a connection

meshes_get_connection_actions

Get available actions (destination endpoints) for a connection

meshes_get_connection_fields

Get destination field configuration for mappings

meshes_get_connection_default_mappings

Get default mappings for a connection

meshes_update_connection_default_mappings

Update default mappings for a connection

meshes_list_rules

List all routing rules

meshes_get_rule

Get details of a specific routing rule

meshes_create_rule

Create an event routing rule mapping events to an action

meshes_delete_rule

Delete an event routing rule

meshes_list_events

List events across the organization with pagination

meshes_get_workspace_events

List events for a workspace with filtered criteria

meshes_get_event

Get event details with delivery status matrix

meshes_get_event_payload

Get event details containing data payload

meshes_retry_event_rule

Retry a failed rule delivery

meshes_list_integrations

Get metadata about all supported integration types

meshes_create_session

Mint a workspace, dashboard, or resource-scoped embed session

meshes_list_sessions

List embedded sessions for a workspace with optional filters

meshes_refresh_session

Refresh an existing session token

meshes_revoke_session

Revoke an embedded session

Development

git clone https://github.com/mesheshq/meshes-mcp-server.git
cd meshes-mcp-server
npm install
npm run build
npm test

What is Meshes?

Meshes is a universal integration layer for SaaS applications. Emit product events once — signups, payments, form submissions — and Meshes routes them to CRMs, email tools, webhooks, and more with retries, fan-out, field mappings, and multi-tenant isolation built in.

Documentation

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers