Precleared

Docs ยท Recipes

Check leads with Precleared before your agent adds them to Salesforge

If your AI agent runs Salesforge through Salesforge's MCP server, connect Precleared's MCP server next to it. Your agent checks each address first, enrols only cleared contacts and puts the rest on Salesforge's do-not-contact list.

What you need

  • A Precleared key. Every new key starts with 14 days at 100 checks a day, then your own 100 a day over MCP, no card needed. Get a free key.
  • Salesforge's MCP server. It takes Salesforge API keys only, one header per product, so use a client that can send headers, such as Claude Code or Cursor.

1. Connect both servers

In Claude Code:

claude mcp add --transport http precleared "https://precleared.dev/mcp?src=guide-salesforge" --header "Authorization: Bearer pc_live_..."
claude mcp add --transport http salesforge https://mcp.salesforge.ai/mcp --header "X-Salesforge-Key: YOUR_SALESFORGE_API_KEY"

Salesforge's own docs show an older form of the second command; this one uses the same address and header in Claude Code's current syntax. You can also run the server yourself from Salesforge's open-source code. For other clients, see Precleared's MCP setup and Salesforge's.

2. Give your agent the rule

Paste this into your agent's instructions, a project's instructions or a skill:

Before enrolling a new contact in a Salesforge sequence, call Precleared's contact_check once for its email address. Send address_source (where you got the address) and sender_country, plus company_name and pitch when you know them.
- ok_to_email: create the contact with create_contact, then enrol it with preflight_enrollments and confirm_enrollment_preflight. Keep the receipt id with the contact.
- consent_needed or blocked: don't enrol the contact. Add the address to the do-not-contact list with add_dnc_entries and note the next_step.
- unknown: don't enrol yet. Supply the missing fact (recipient_country, default_recipient_country if all your prospects are in one country, or company_number), then check again.
Every email must meet footer_text: usually who you are, a postal address and a way to opt out.

What happens to each lead

VerdictWhat your agent does in Salesforge
ok_to_emailCreates and enrols the contact, keeping the receipt id
consent_needed or blockedLeaves the contact out and adds the address to the do-not-contact list
unknownHolds the contact until the missing fact is supplied, then checks again

Good to know

  • add_dnc_entries takes up to 1,000 emails or domains in one call.
  • Salesforge's enrolment preflight checks other sequences and replies. It doesn't check whether a cold email is allowed, which is what Precleared adds.
  • Contacts that Agent Frank, Salesforge's AI SDR, adds by itself don't pass through your agent.
  • Salesforge's docs don't list its tool names, so these come from its open-source MCP code as of 30 October 2026. If they change, your agent sees the new names in the server's tool list.
  • The ?src=guide-salesforge tag on Precleared's address only tells us which guide you used. It doesn't change your allowance or your results.

Every check has a signed receipt. Open precleared.dev/r/ followed by its id to show a client why an email went out.

Decision support with sources, not legal advice.