How does x402 payments work in primitive?

One party registers a payout address and requests a USDC payment; the paying agent signs locally with its own key. Keys never leave the caller, and settlement occurs on the chosen network (base or base-sepolia).

Do I need an API key to use primitive?

Yes. The outbound client requires a `PRIMITIVE_API_KEY`, and webhook verification uses a `PRIMITIVE_WEBHOOK_SECRET`.

What credentials does it need?

It reads `PRIMITIVE_API_KEY`, `PRIMITIVE_WEBHOOK_SECRET` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Primitive MCP Server

Official Node.js, Python, and Go SDKs plus the primitive CLI for Primitive — email infrastructure for AI agents. Generated from the OpenAPI spec.

Local serverstdioPython

What is the Primitive MCP Server?

Official Node.js, Python, and Go SDKs plus the primitive CLI for Primitive — email infrastructure for AI agents. Generated from the OpenAPI spec.

What it actually does

Primitive is an inbound and outbound email platform. The SDKs are centered on a small default workflow:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Primitive MCP Server

{
  "mcpServers": {
    "sdks-primitivedotdev": {
      "command": "npx",
      "args": ["-y", "@primitivedotdev/sdk"],
      "env": {
        "PRIMITIVE_API_KEY": "your-value",
        "PRIMITIVE_WEBHOOK_SECRET": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
PRIMITIVE_API_KEY	Credential the server authenticates with.	Yes
PRIMITIVE_WEBHOOK_SECRET	Credential the server authenticates with.	Yes

Frequently asked questions

Node.js (npm), Python (pip), and Go (go get) are officially supported.

Alternatives to the Primitive MCP Server

Slack Archived Reference

Your assistant inside the workspace — read channels, search history, post messages and tame the noise.

CommunicationTypeScript★ 63.0k

Fonoster

Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.

AI & ML ServicesTypeScript★ 8.1k

Gmail

Inbox intelligence — search, read, draft and send Gmail through your assistant with OAuth auto-setup.

Email & Inbox ManagementTypeScript★ 2.1k

Atlassian Rovo

Official

Read and write Jira, Confluence, Bitbucket, JSM and Compass from your AI client — with your own permissions.

Productivity & Project ManagementRemoteJavaScript★ 923

Read and send Telegram messages through your assistant — chats, channels and history via the client API.

CommunicationPython★ 800

Discord

Enables Discord bot integration with Model Context Protocol (MCP) compatible applications like Claude Desktop.

CommunicationGo★ 440