@mesheshq/mcp-server

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
Routing Rules — create and update event routing rules
Connections — manage integration connections (HubSpot, Salesforce, Mailchimp, etc.)
Delivery Status — inspect event delivery logs and retry status

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 | meshes_emit_bulk_events | meshes_list_workspaces | meshes_get_workspace | meshes_create_workspace | meshes_update_workspace | meshes_list_connections | meshes_get_connection | meshes_create_connection | meshes_update_connection | meshes_delete_connection | meshes_get_connection_actions | meshes_get_connection_fields | meshes_get_connection_default_ | meshes_list_rules | meshes_get_rule | meshes_create_rule | meshes_delete_rule | meshes_list_events | meshes_get_workspace_events | meshes_get_event | meshes_get_event_payload | meshes_retry_event_rule | meshes_list_integrations | ------------------------ | | Emit a product event to Meshes for routing and delivery | | Emit up to 100 events in a single request | | List all workspaces in the multi-tenant organization | | Get details of a specific workspace | | Create a new workspace | | Update workspace properties | | List connections for a workspace | | Get details of a connection | | Create a new connection destination | | Update connection configuration metadata | | Delete a connection | | Get available actions (destination endpoints) for a connection | | Get destination field configuration for mappings | mappings | Get default mappings for a connection | | List all routing rules | | Get details of a specific routing rule | | Create an event routing rule mapping events to an action | | Delete an event routing rule | | List events across the organization with pagination | | List events for a workspace with filtered criteria | | Get event details with delivery status matrix | | Get event details containing data payload | | Retry a failed rule delivery | | Get metadata about all supported integration types |

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

MCP Servers