# agents.txt for Cold Leads — format: IETF draft-car-agents-txt-wellknown-00 (Informational)
# Full reference for AI agents: https://coldleads.app/llms-full.txt · summary: https://coldleads.app/llms.txt
# Detailed capability manifest (tools, side effects, approval rules): https://coldleads.app/.well-known/agent-capabilities.json
# MCP server card: https://coldleads.app/.well-known/mcp/server-card.json
Spec-Version: 1.0
Agents-JSON: https://coldleads.app/.well-known/agents.json
Site-Name: Cold Leads
Site-URL: https://coldleads.app
Site-Description: CRM and sales execution layer for humans and AI agents: lead memory, e-mail verification, outreach with human approval, reply tracking, follow-ups. No third-party lead database.
Site-Contact: support@coldleads.app
Site-Privacy-Policy: https://coldleads.app/privacy

Capability: mcp-server
  Endpoint: https://coldleads.app/api/mcp
  Protocol: MCP
  Method: POST
  Auth: oauth2
  Auth-Endpoint: https://coldleads.app/oauth/token
  Auth-Docs: https://coldleads.app/solutions/for-ai-agents
  Scopes: mcp
  Description: Hosted MCP server (Streamable HTTP) with 18 sales tools: contacts, verification, templates, campaigns with human approval, conversations, next actions, follow-ups, audit log. OAuth 2.1 or Authorization: Bearer sk_ (Business plan).

Capability: verify-email
  Endpoint: https://coldleads.app/api/v1/verify
  Protocol: REST
  Method: POST
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Verify one e-mail address (1 credit).
  Param: email (body, string, required) - Address to verify
  Param: timeout_ms (body, integer) - Time budget 1000-30000 ms

Capability: verify-bulk
  Endpoint: https://coldleads.app/api/v1/verify/bulk
  Protocol: REST
  Method: POST
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Start a bulk verification job (1 credit per address).
  Param: emails (body, string, required) - Array of addresses
  Param: name (body, string) - Job name

Capability: find-email
  Endpoint: https://coldleads.app/api/v1/find
  Protocol: REST
  Method: POST
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Most likely address by name and company domain (1 credit).
  Param: domain (body, string, required) - Company domain

Capability: lead-search
  Endpoint: https://coldleads.app/api/v1/leads
  Protocol: REST
  Method: GET
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Contacts already in the workspace CRM at a domain (free; no third-party database).
  Param: domain (query, string, required) - Company domain
  Param: role (query, string) - Keyword such as sales
  Param: limit (query, integer) - 1-50

Capability: lead-context
  Endpoint: https://coldleads.app/api/v1/leads/context
  Protocol: REST
  Method: GET
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Everything known about one lead: contactability, history, last reply class, next action (free).
  Param: contact_id (query, string) - Contact id
  Param: email (query, string) - Alternative to contact_id

Capability: next-actions
  Endpoint: https://coldleads.app/api/v1/next-actions
  Protocol: REST
  Method: GET
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Replies waiting for an answer and follow-ups that are due (free).
  Param: limit (query, integer) - 1-100

Capability: schedule-follow-up
  Endpoint: https://coldleads.app/api/v1/follow-ups
  Protocol: REST
  Method: POST
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Set, move or clear a contact's next action; never sends e-mail (free).
  Param: contact_id (body, string) - Or email
  Param: due_at (body, string) - ISO 8601
  Param: in_days (body, integer) - Alternative to due_at
  Param: note (body, string) - What to do

Capability: agent-activity
  Endpoint: https://coldleads.app/api/v1/activity
  Protocol: REST
  Method: GET
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Audit log of this workspace's API and MCP calls, no personal data (free).
  Param: limit (query, integer) - 1-200

Capability: credits
  Endpoint: https://coldleads.app/api/v1/credits
  Protocol: REST
  Method: GET
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  OpenAPI: https://coldleads.app/api/v1/openapi.json
  Description: Plan and remaining credits (free).

Capability: website-lead
  Endpoint: https://coldleads.app/api/hooks/lead
  Protocol: REST
  Method: POST
  Auth: api-key
  Auth-Docs: https://coldleads.app/developers
  Rate-Limit: 120/minute
  Description: Submit a website enquiry as a lead with a publishable website key lk_ (every plan).
  Param: email (body, string, required) - Visitor e-mail
  Param: name (body, string) - Visitor name
  Param: key (query, string, required) - Website key lk_

Capability: agent-onboarding
  Endpoint: https://coldleads.app/api/agent/provision
  Protocol: REST
  Method: POST
  Auth: none
  Description: No key yet: returns a payment link for the human owner (Business plan) and a claim token.
  Param: owner_email (body, string, required) - Human owner's e-mail
  Param: agent_id (body, string, required) - Agent name

Allow: /api/v1/*
Allow: /api/mcp
Allow: /api/hooks/lead
Allow: /api/agent/*
Disallow: /api/cron/*
Disallow: /api/admin/*

Agent: *
  Rate-Limit: 120/minute