How to build an AI sales agent

import os, httpx

class HotHawk:
    """A thin client over the HotHawk REST API. Bearer auth, JSON in and out.
    Exact paths and payloads are in the API reference at /developers."""

    def __init__(self, token=None, base="https://api.hothawk.ai"):
        self.base = base
        self.h = {"Authorization": f"Bearer {token or os.environ['HOTHAWK_API_KEY']}"}

    def create_campaign(self, name, list_id):
        r = httpx.post(f"{self.base}/v1/campaigns", headers=self.h,
                       json={"name": name, "list_id": list_id})
        r.raise_for_status()
        return r.json()

    def activate(self, campaign_id):
        httpx.post(f"{self.base}/v1/campaigns/{campaign_id}/activate",
                   headers=self.h).raise_for_status()

    def replies(self, since=None):
        r = httpx.get(f"{self.base}/v1/threads", headers=self.h,
                      params={"status": "replied", "since": since})
        r.raise_for_status()
        return r.json()["data"]

# pip install claude-agent-sdk   (Python 3.10+; bundles the Claude Code binary)
import anyio
from claude_agent_sdk import query, ClaudeAgentOptions, tool, create_sdk_mcp_server

hh = HotHawk()  # the REST client above

@tool("launch_campaign", "Create and activate a cold email campaign in HotHawk",
      {"name": str, "list_id": str})
async def launch_campaign(args):
    campaign = hh.create_campaign(args["name"], args["list_id"])
    hh.activate(campaign["id"])
    return {"content": [{"type": "text", "text": f"Launched campaign {campaign['id']}"}]}

# Wrap the REST client as an in-process tool the agent can call.
hothawk = create_sdk_mcp_server(name="hothawk", version="1.0.0", tools=[launch_campaign])

options = ClaudeAgentOptions(
    model="claude-opus-4-8",
    mcp_servers={"hothawk": hothawk},
    allowed_tools=["mcp__hothawk__launch_campaign"],
    system_prompt="You run outbound for a B2B SaaS. Propose, then act. Keep the human in control.",
)

async def main():
    async for message in query(prompt="Launch a campaign to the Q3 SaaS list.", options=options):
        print(message)

anyio.run(main)

// npm install @anthropic-ai/claude-agent-sdk   (Node 18+; same shape as Python)
import { query, tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";

const launchCampaign = tool(
  "launch_campaign",
  "Create and activate a cold email campaign in HotHawk",
  { name: String, list_id: String },
  async ({ name, list_id }) => {
    const c = await hh.createCampaign(name, list_id);
    await hh.activate(c.id);
    return { content: [{ type: "text", text: `Launched campaign ${c.id}` }] };
  },
);

const hothawk = createSdkMcpServer({ name: "hothawk", version: "1.0.0", tools: [launchCampaign] });

for await (const message of query({
  prompt: "Launch a campaign to the Q3 SaaS list.",
  options: { model: "claude-opus-4-8", mcpServers: { hothawk } },
})) {
  console.log(message);
}

# From Claude Code, or at claude.ai/code/routines in the browser
/schedule

name = "hothawk-sdr"
main = "src/index.ts"
compatibility_date = "2026-07-01"

# Cron triggers run on the Workers free tier at no extra cost (July 2026).
[triggers]
crons = ["0 8 * * 1-5"]   # 08:00 UTC, Monday to Friday

[vars]
HOTHAWK_BASE = "https://api.hothawk.ai"

# Secrets are set out of band, never in the file:
#   wrangler secret put HOTHAWK_API_KEY
#   wrangler secret put ANTHROPIC_API_KEY

export interface Env {
  HOTHAWK_BASE: string;
  HOTHAWK_API_KEY: string;
  ANTHROPIC_API_KEY: string;
}

export default {
  // The cron trigger calls this handler. Nothing to keep running between shifts.
  async scheduled(event: ScheduledController, env: Env, ctx: ExecutionContext) {
    ctx.waitUntil(runShift(env));
  },
};

async function runShift(env: Env) {
  const h = {
    Authorization: `Bearer ${env.HOTHAWK_API_KEY}`,
    "content-type": "application/json",
  };

  // 1. Read overnight replies from HotHawk.
  const { data: replies } = await fetch(
    `${env.HOTHAWK_BASE}/v1/threads?status=replied`, { headers: h },
  ).then((r) => r.json());

  // 2. (optional) Let Claude decide what to do with each one. See the brain below.

  // 3. Launch today's campaign through HotHawk. HotHawk does the sending.
  const campaign = await fetch(`${env.HOTHAWK_BASE}/v1/campaigns`, {
    method: "POST", headers: h,
    body: JSON.stringify({ name: "Daily SaaS outbound", list_id: "lst_q3_saas" }),
  }).then((r) => r.json());

  await fetch(`${env.HOTHAWK_BASE}/v1/campaigns/${campaign.id}/activate`, {
    method: "POST", headers: h,
  });
}

// The brain: one Claude call from inside the Worker.
// Swap the URL for your AI Gateway endpoint to add caching, retries and logs.
async function draftReply(env: Env, incoming: string) {
  const res = await fetch("https://api.anthropic.com/v1/messages", {
    method: "POST",
    headers: {
      "x-api-key": env.ANTHROPIC_API_KEY,
      "anthropic-version": "2023-06-01",
      "content-type": "application/json",
    },
    body: JSON.stringify({
      model: "claude-opus-4-8",
      max_tokens: 1024,
      messages: [{ role: "user", content: `Draft a short reply to this prospect:\n\n${incoming}` }],
    }),
  }).then((r) => r.json());
  return res.content[0].text;
}