Build against Tamoia.

Discover capabilities, read pricing, verify trust, and integrate through open protocols.

Zero Installation • Live on npm

Connect your AI assistant to Tamoia CRM in 3 simple steps

Run Claude Desktop or Cursor on your local machine with full CRM access. Push CSV leads, query contacts, inspect pipeline stages, and log meeting signals.

npm: @tamoia/mcp-server ↗

01Takes 10s

Get Organization Agent Key

Log into your Tamoia CRM instance, navigate to Leads → AI settings, and generate your organization key.

tmg_live_xxxxxxxxxxxxxxxxxxxxxxxx

Open CRM AI settings ↗

021-Click Config

Add to Claude or Cursor

Paste the @tamoia/mcp-server block into your client configuration. No local builds needed!

03Prompt Away

Prompt Your AI

Restart your client. Claude will automatically read your tools and execute actions on your CRM.

“Read customers.csv. First call tamoia_import_csv_suggest_mapping with the headers. Then import the contacts in batches of 30 contacts per call using tamoia_import_csv, skipping any rows without a valid email address.”

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

claude_desktop_config.json

{
  "mcpServers": {
    "tamoia": {
      "command": "npx",
      "args": [
        "-y",
        "@tamoia/mcp-server"
      ],
      "env": {
        "TAMOIA_API_BASE_URL": "https://api.tamoia-crm.com",
        "TAMOIA_AGENT_KEY": "tmg_YOUR_ORGANIZATION_AGENT_KEY"
      }
    }
  }
}

• Replace tmg_YOUR_ORGANIZATION_AGENT_KEY with your real key from Lead AI settings.

• Restart Claude Desktop. The tools icon in Claude will reveal all 9 Tamoia CRM tools.

Protocols supported

MCPlive

Tool integration for agent workflows. CRM operations via @tamoia/mcp-server (stdio) or REST.

A2Aroadmap

Agent-to-agent communication and discovery.

UCProadmap

Universal commerce protocol for agent transactions.

AP2roadmap

Signed-consent payments and mandates.

Discovery endpoints

Read-only. No authentication. Use these to inspect Tamoia capabilities, pricing models, and public metadata.

Agent discovery

https://tamoia.com/.well-known/agent.json

LLM context

https://tamoia.com/llms.txt

Pricing

https://tamoia.com/pricing.json

CRM operations & architecture

Discovery lives on tamoia.com. Lead pipeline operations run against the Tamoia CRM API. Each customer org provisions its own agent key — you never connect to a developer's local machine.

CRM API base

https://api.tamoia-crm.com

Integration guide

https://tamoia.com/agents#operations

Authentication

Header X-Tamoia-Agent-Key with your org-wide agent key, or Authorization: Bearer tmg_...

Provision in Tamoia CRM → Lead AI settings → Organization agent API key.

MCP package on npm

@tamoia/mcp-server ↗

Transport: stdio. Runs on your machine via stdio (`npx -y @tamoia/mcp-server`).

Discovery capabilities

discover capabilities

live

List what Tamoia can do.

get pricing

live

Return outcome-based pricing as structured data.

verify trust

roadmap

Return verifiable consent and ownership descriptors.

create outcome contract

roadmap

Open an outcome-priced engagement.

Agent integration lifecycle

01Discover Tamoia through the public agent card and pricing.json.
02Onboard to Tamoia CRM and generate an org-wide agent API key.
03Connect your bot with X-Tamoia-Agent-Key or the MCP server package.
04Ingest signals and read lead stage status — outcomes meter toward billing.

Self-attestation

Tamoia self-attests to the capabilities and pricing declared in its discovery endpoints. Agents verify and sign transactions under the Universal Commerce Protocol (UCP).

protocol: UCP · AP2 · MCP · A2A