API and MCP. One surface.

90 MCP tools.

Campaigns, inbox, Knowledge Base, CRM sync, line health, AI credits, and reactivation are already exposed.

One npm package.

Install `tuco-mcp` once and use the same server across Claude, Cursor, Windsurf, and future MCP clients.

Real workflow coverage.

This is not a toy wrapper around send-message. It reaches campaigns, KB approvals, inbox work, and CRM-aware logic.

API + agent surface.

Use REST when code should drive. Use MCP when a person or AI should operate the workspace by chat.

npx tuco-mcp

{
  "mcpServers": {
    "tuco": {
      "command": "npx",
      "args": ["tuco-mcp"],
      "env": {
        "TUCO_API_KEY": "your_api_key_here"
      }
    }
  }
}

REST API

Send messages, manage leads, retrieve replies, and work the platform with predictable HTTP calls.

Signed Webhooks

Receive sent, failed, fallback, reply, and opened events without polling or brittle status checks.

tuco-mcp

Let Claude, Cursor, or Windsurf run the workspace with natural language across 90 live tools.

Custom Tools

Build reusable API tools once, test them on a real lead, then reuse them inside campaigns and AI bots.

CRM Write-Back

Sync HubSpot and GoHighLevel, map owners and properties, and push the right updates back after the reply.

Reactivation

Scan dormant conversations, tune reactivation rules, and trigger the next AI motion from code or MCP.

cURL

curl -X POST https://api.tuco.ai/v1/messages \
  -H "Authorization: Bearer $TUCO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15551234567",
    "body": "Hi Sarah — saw you booked a demo. Quick q before we meet?",
    "lineId": "line_abc123"
  }'

Python

import os, requests

resp = requests.post(
    "https://api.tuco.ai/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['TUCO_API_KEY']}"},
    json={
        "to": "+15551234567",
        "body": "Hi Sarah — saw you booked a demo. Quick q before we meet?",
        "lineId": "line_abc123",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json()["id"])

Node.js

import fetch from "node-fetch";

const r = await fetch("https://api.tuco.ai/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.TUCO_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+15551234567",
    body: "Hi Sarah — saw you booked a demo. Quick q before we meet?",
    lineId: "line_abc123",
  }),
});

if (!r.ok) throw new Error(await r.text());
const { id } = await r.json();
console.log(id);

Webhook (verify)

import crypto from "crypto";

export function verifyTucoWebhook(rawBody, signatureHeader, secret) {
  const expected = crypto
    .createHmac("sha256", secret)
    .update(rawBody)
    .digest("hex");
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(signatureHeader),
  );
}