clay-gtm-cli

Clay.com in your terminal. Fire webhooks, receive async enrichment callbacks, and track row limits — from a single command line.

Agent-native CLI + MCP server. Built for humans, scripts, and AI agents.

npm install -g clay-gtm-cli

What This CLI Enables

Clay.com is a powerful data enrichment and workflow platform. Tables are triggered via webhooks, process data through enrichment steps, and can return results via HTTP callbacks.

clay-gtm-cli wraps this into a simple, scriptable interface:

Fire webhooks — send any JSON payload to a Clay table
Async callbacks — wait for Clay to finish processing and receive enriched data back
Row limit tracking — know when tables approach the 50k limit, and reset with new URLs
MCP server — every command is an AI tool for Claude, Cursor, or any MCP client

How It Works

Agent/Script                    clay-gtm-cli                     Clay.com
     |                             |                            |
     |-- clay fire --wait -------->|                            |
     |                             |-- POST webhook URL ------->|
     |                             |   (payload + callback_url) |
     |                             |                            |-- enrich/validate/etc.
     |                             |                            |
     |                             |<---- POST callback_url ----|
     |                             |      (enriched data)       |
     |<--- return enriched JSON ---|                            |

You register Clay webhook tables with clay tables add
clay listen start spins up a local HTTP server + cloudflared tunnel
clay fire <table> --data '{...}' --wait fires the webhook and blocks until Clay posts back
The enriched data is returned as structured JSON

Setup

Step 1 — Install

npm install -g clay-gtm-cli

Step 2 — Install cloudflared (for async callbacks)

# macOS
brew install cloudflared

# Linux
sudo apt install cloudflared

# Other
# https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/

Step 3 — Register a webhook table

Create a webhook table in Clay.com, copy the webhook URL, then:

clay tables add \
  --name enrich-lead \
  --webhook-url https://app.clay.com/webhook/abc123 \
  --description "Enrich LinkedIn profile + find email"

Step 4 — Start the listener

clay listen start

This prints a public HTTPS callback URL (via trycloudflare.com). Configure the last step in your Clay table to POST to {{_callback_url}} with the enriched data.

Step 5 — Fire and wait

clay fire enrich-lead \
  --data '{"linkedin_url": "https://linkedin.com/in/jdoe"}' \
  --wait

The CLI blocks until Clay finishes processing and posts the result back.

Quick Start

# Register a table
clay tables add --name enrich-lead --webhook-url https://app.clay.com/webhook/abc123

# Start listener (in another terminal)
clay listen start

# Fire and wait for enriched data
clay fire enrich-lead --data '{"linkedin_url": "https://linkedin.com/in/jdoe"}' --wait

# Check usage
clay usage show

# Fire without waiting (fire-and-forget)
clay fire log-event --data '{"event": "demo_booked"}'

Commands

Tables

clay tables add --name <n> --webhook-url <url> [--auth-key <key>] [--description <text>]
clay tables list
clay tables get <name>
clay tables update <name> [--webhook-url <url>] [--auth-key <key>]
clay tables remove <name>
clay tables reset <name> --webhook-url <new-url>

Fire

clay fire <table> --data '<json>' [--wait] [--timeout <seconds>]

Listen

clay listen start [--port <number>]
clay listen status

Usage

clay usage show [table-name]
clay usage sync

Config

clay config get
clay config set --callback-url <url>

MCP

clay mcp

Output

All commands output JSON. Pipe to jq, save to files, or feed to other tools.

# Pretty print
clay tables list --pretty

# Select fields
clay tables list --fields "name,rowsUsed"

# Quiet mode (exit code only)
clay fire enrich-lead --data '...' --quiet

Row Limit Management

Clay tables have a 50,000 row limit. The CLI tracks usage automatically.

# Check usage
clay usage show enrich-lead
# → {"table":"enrich-lead","rowsUsed":48500,"rowLimit":50000,"remaining":1500,"percentUsed":97}

# When at 50k: duplicate table in Clay, get new webhook URL, then:
clay tables reset enrich-lead --webhook-url https://app.clay.com/webhook/new456

MCP Server

Every command is available as an MCP tool for AI assistants.

clay mcp

Configure in Claude Desktop / Cursor

{
  "mcpServers": {
    "clay": {
      "command": "npx",
      "args": ["clay-gtm-cli", "mcp"]
    }
  }
}

Tools registered: tables_add, tables_list, tables_get, tables_update, tables_remove, tables_reset, fire, listen_start, listen_status, usage_show, usage_sync, config_set, config_get.

Clay Table Setup (for the human)

To make a Clay table work with clay-gtm-cli callbacks:

Create a webhook table in Clay.com
Set the trigger to "Webhook"
Copy the webhook URL and register it: clay tables add --name <name> --webhook-url <url>
Add enrichment steps (Enrich Person, Find Email, Validate Email, etc.)
Add a final HTTP API step:
- Method: POST
- URL: Use the _callback_url column (auto-injected by clay-gtm-cli when using --wait)
- Body: Map the enriched columns you want sent back

That's it. The agent fires clay fire <name> --data '...' --wait and receives the enriched response.

Agent Skills

The repo ships 21 GTM Engineer skills (SKILL.md files) covering every stage of the revenue lifecycle — prospecting, enrichment, personalization, routing, reply handling, CRM ops, and post-sale expansion.

Prospecting & List Building

Skill	Use Case
`skills/clay-prospect-list/`	Build targeted prospect lists from ICP filters (industry, size, title, tech, funding)
`skills/clay-lookalike/`	Find lookalike prospects from your best customer domains
`skills/clay-champion-track/`	Monitor champions who leave customers → instant warm outreach at new company

Lead Enrichment

Skill	Use Case
`skills/clay-enrich-lead/`	Enrich a LinkedIn profile — name, title, company, bio
`skills/clay-find-email/`	Waterfall email finding across Hunter/Apollo/Clearbit + validation
`skills/clay-company-research/`	Company enrichment — size, funding, tech stack, hiring, news
`skills/clay-outbound-prep/`	Full pipeline in one shot — enrich + email + ICP score + AI first-line

Signals & Triggers

Skill	Use Case
`skills/clay-icp-score/`	ICP qualification scoring — fit tier (A/B/C/D) + signal breakdown
`skills/clay-job-change/`	Job change + hiring signal detection — highest-intent buying trigger
`skills/clay-intent-data/`	G2/Bombora intent signals — who is researching your category right now
`skills/clay-news-trigger/`	Funding, executive hires, product launches, expansions — outreach timing events
`skills/clay-website-visitor/`	Deanonymize website visitors — IP to company + buyer contact

Account-Based Marketing

Skill	Use Case
`skills/clay-account-research/`	ABM account research — buying committee, engagement strategy, account tier

Personalization & Sequencing

Skill	Use Case
`skills/clay-personalize/`	AI first lines, subject lines, and LinkedIn notes from enriched data
`skills/clay-sequence-router/`	Multi-signal routing — sequence assignment, rep routing, send timing
`skills/clay-suppression-check/`	Validate against opt-out, DNC, competitor, and customer lists before any send
`skills/clay-reply-classify/`	Classify inbound replies — interested/objection/unsubscribe + recommended next action

CRM & Data Ops

Skill	Use Case
`skills/clay-crm-sync/`	Enrich and write back to Salesforce/HubSpot CRM records
`skills/clay-data-hygiene/`	Normalize titles, clean company names, validate emails, flag duplicates

Post-Sale & Expansion

Skill	Use Case
`skills/clay-expansion-signals/`	Detect upsell/expansion readiness — team growth, usage limits, funding
`skills/clay-renewal-research/`	Pre-renewal account intelligence — health, champion stability, competitive risk

Install all skills at once

npx skills add https://github.com/bcharleson/clay-gtm-cli

Install a specific skill

npx skills add https://github.com/bcharleson/clay-gtm-cli/tree/main/skills/clay-outbound-prep

OpenClaw agent setup

# Symlink all skills (stays in sync with repo)
ln -s $(pwd)/skills/clay-* ~/.openclaw/skills/

Development

git clone https://github.com/bcharleson/clay-gtm-cli.git
cd clay-gtm-cli
npm install
npm run dev -- tables list
npm run build
npm run typecheck

Architecture

Every command is a CommandDefinition — one source of truth powering both the CLI subcommand and the MCP tool:

src/
├── core/
│   ├── types.ts      # CommandDefinition interfaces
│   ├── client.ts     # HTTP client (retry, rate limit)
│   ├── config.ts     # ~/.clay/ config management
│   ├── errors.ts     # Typed error classes
│   ├── output.ts     # JSON output formatting
│   ├── usage.ts      # Row count tracking
│   ├── listener.ts   # Local HTTP callback server
│   └── tunnel.ts     # cloudflared tunnel management
├── commands/
│   ├── tables/       # 6 commands
│   ├── fire/         # 1 command (the core one)
│   ├── listen/       # 2 commands
│   ├── usage/        # 2 commands
│   └── config/       # 2 commands
└── mcp/
    └── server.ts     # MCP server (auto-registers all commands)

Adding a new command = one new file. It's automatically available in both CLI and MCP.

License

MIT

Inspired by

bcharleson/instantly-cli — architecture pattern
bcharleson/ms365-cli — CommandDefinition pattern
googleworkspace/cli — agent-native CLI design

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
skills		skills
src		src
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsup.config.ts		tsup.config.ts

Folders and files

Latest commit

History

Repository files navigation

clay-gtm-cli

What This CLI Enables

How It Works

Setup

Step 1 — Install

Step 2 — Install cloudflared (for async callbacks)

Step 3 — Register a webhook table

Step 4 — Start the listener

Step 5 — Fire and wait

Quick Start

Commands

Tables

Fire

Listen

Usage

Config

MCP

Output

Row Limit Management

MCP Server

Configure in Claude Desktop / Cursor

Clay Table Setup (for the human)

Agent Skills

Prospecting & List Building

Lead Enrichment

Signals & Triggers

Account-Based Marketing

Personalization & Sequencing

CRM & Data Ops

Post-Sale & Expansion

Install all skills at once

Install a specific skill

OpenClaw agent setup

Development

Architecture

License

Inspired by

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages