primitive

Name: primitive
Author: primitivedotdev

@primitivedotdev

primitive について

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

#email

基本情報

カテゴリ

その他

ライセンス

MIT

ランタイム

node

トランスポート

stdio

公開者

primitivedotdev

投稿者

Ethan Byrd

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "primitive": {
      "url": "https://www.primitive.dev/mcp",
      "headers": {
        "Authorization": "Bearer prim_YOUR_API_KEY"
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is primitive?

Primitive is an inbound and outbound email platform with SDKs for Node.js, Python, and Go. It centers on a small default workflow: receive an inbound email, inspect a normalized email object, and send, reply, or forward synchronously. The SDKs also include a non-custodial x402 payments client for USDC transactions.

How to use primitive?

Install the SDK for your language (npm install @primitivedotdev/sdk, pip install primitivedotdev, or go get github.com/primitivedotdev/sdks/sdk-go@latest). Use receive(...) to parse an incoming email, client(...) to create an outbound client with an API key, and then send(...), reply(...), or forward(...) to act on the email.

Key features of primitive

Inbound email parsing and synchronous outbound sending
Non-custodial x402 payments on Base and Base-Sepolia
SDKs for Node.js, Python, and Go
Webhook verification and MIME parsing helpers
Low-level generated APIs and OpenAPI exports
Primitive Memories key-value store operations

Use cases of primitive

Automate email replies from a webhook endpoint
Send, reply, or forward emails programmatically
Accept USDC micro‑payments before processing an email action
Build custom email workflows with raw MIME or API access

FAQ from primitive

What languages does the primitive SDK support?

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

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.

Are there lower-level APIs beyond the default workflow?

Yes. The SDKs also expose raw webhook parsing, generated HTTP API packages, MIME parsing, and a CLI for advanced use cases.

Where is email data stored?

Primitive provides a key‑value store called Primitive Memories for custom data, but the README does not specify where email payloads themselves are stored.