Free Tools free_tools
Kenso's free tools from ken.so/tools: list cleaners, copy checks, spintax, outbound calculators, domain and DNS checks and records, blacklist and SMTP tests. Each operation takes kind and input; calls count against your Kenso account's free limits and every result carries source_url, the tool's page.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through free_tools_read. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.
Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.
Operations: calculate, check_blacklist, check_copy, check_domain, clean, dns_lookup, generate_dns_record, smtp_test, spintax
calculate
Read.
Run a ken.so outbound calculator: funnel, costs, ROI, quota, forecast, inboxes, warmup, rates, A/B tests.
The ken.so calculators, the same math as the pages, with their sources.
Rates are fractions (0.03 is 3%). Impossible input comes back as a validation
error with `details.issues`. Returns the API's JSON with `source_url`.
Kinds and their `input` (required fields first):
- funnel: `nodes` (id, label, kind, volume, role, costs), `edges` (from, to,
rate), `dealSize`; `salesCycleMonths`, `months`.
- outbound_cost: `leadsPerMonth`, `channels` ({email, linkedin}); `teamSize`,
`diyModel`, `agencyRetainer`, `meetingsPerSdrMonth`.
- pipeline_roi: `leadsPerMonth`, `replyRate`, `positiveRate`, `meetingRate`,
`showRate`, `closeRate`, `dealSize`, `monthlyCost`; `salesCycleMonths`.
- sdr_cost: all optional: `country` (US, GB, CA, AU, IE, NZ), `stage`,
`baseSalary`, `commission`, `toolsMonthly`, `tenureMonths`, `rampMonths`, ...
- quota: `mode` "top-down" (`revenueTarget`, `reps`, `dealSize`) or "bottom-up"
(`dealSize`, `winRate`, `salesCycleMonths`).
- forecast: `mode` "pipeline" (`deals`, `stageProbabilities`, `startMonth`) or
"outbound" (`sendsPerMonth`, `dealSize`).
- infrastructure: `provider` (google, microsoft, azure, smtp) and
`emailsPerMonth` or `meetingsGoal`.
- warmup_schedule: `provider` (google, microsoft, smtp), `targetDaily`;
`inboxAgeDays`.
- rate: `rate` (bounce, spam-complaint, open, reply, positive-reply, click),
`numerator`, `denominator`.
- ab_test: `mode` "sample-size" (`baselineRate`) or "significance" (`a` and `b`,
each {sent, successes}).
- agency_pricing: `clients`, `leadsPerClient`, `channels`, `hoursPerClient`;
`targetMargin`, `hourlyCost`, `currentRetainer`.
- linkedin_limits: `accountType` (free, premium, sales-navigator, recruiter),
`accountAgeMonths`; `ssi`, `acceptanceRate`, `pendingInvites`.
Example:
free_tools(operation="calculate", kind="rate", input={"rate": "bounce", "numerator": 64, "denominator": 2400})
check_blacklist
Read.
Check a domain or IPv4 address against DNS blocklists.
`input`: `target` (a domain or an IPv4 address). Checks the blocklists whose
terms allow automated lookups, with what each listing means and where to
delist; the rest come back under `skipped` with a link to check by hand.
100 checks a day per Kenso account. Returns the API's JSON with `source_url`.
Example:
free_tools(operation="check_blacklist", input={"target": "acme.com"})
check_copy
Read.
Grade a cold email, find AI tells and spam words, score a subject line, check compliance.
The rules layer of the ken.so copy tools. No model runs. Returns the API's
JSON with `source_url`.
Kinds and their `input`:
- grade: `subject`, `body` and/or `html`; `contentType` (cold-email or
follow-up-email), `vertical`, `country` (ISO2, adds compliance checks).
`rulesScore` is 100 minus every point the checks took, each with a fix.
- ai_tells: `text`, `contentType` (default cold-email). How human it reads,
0 to 100, and each phrase that reads as AI with a plainer alternative.
- spam_words: `subject`, `body` and/or `html`; `vertical`, `attachments`,
`openTracking`, `step` (sequence step, default 1).
- subject_line: `subject`, optional `firstLine`. Score 0 to 100 and how mail
clients cut it off.
- compliance: `subject`, `body` and/or `html`, and `country` (ISO2, required).
CAN-SPAM, CASL, PECR, UK GDPR or GDPR checks by recipient country. Not legal
advice.
Example:
free_tools(operation="check_copy", kind="subject_line", input={"subject": "Northwind's Leeds warehouse"})
check_domain
Read.
Check a domain's email setup: health grade, SPF, DKIM, DMARC, BIMI, MTA-STS, TLS-RPT, RDAP.
Live DNS, RDAP and HTTPS checks from ken.so. Each domain counts as one lookup
against your Kenso account's daily limit; results may come from a short cache
(`cached`, `cachedAt`). `domain` may be a domain, URL or email. Returns the
API's JSON with `source_url`.
Kinds and their `input`:
- health: `domain` (one, or a list of up to 20), `selectors` (extra DKIM
selectors). The A to F grade from twelve checks with the record to paste for
each fix.
- spf: `domain`. The record, its include tree, lookup and void counts.
- spf_flatten: `domain`. Includes resolved to ip4/ip6, chained past 450
characters. Re-run before you publish.
- dkim: `domain`, `selector` (list; omit for the 20-selector sweep).
- dmarc: `domain`. Every tag, the fallback and the next policy step.
- bimi: `domain`, `selector`. Record, logo and certificate checks.
- mta_sts: `domain`. Record, policy file and MX coverage.
- tls_rpt: `domain`. The _smtp._tls record.
- rdap: `domain`. Registrar, registration and expiry dates, or availability.
Example:
free_tools(operation="check_domain", kind="dmarc", input={"domain": "acme.com"})
clean
Read.
Clean company names, person names, job titles, domains, phone numbers or lead rows.
The ken.so list cleaners, rules first. Lists take 1 to 100 values a call;
each value counts as one item against your Kenso account's daily limit.
Returns the API's JSON (`results`, plus `ai` when asked) with `source_url`,
the tool's page.
Kinds and their `input`:
- company_name: `names` (list) or `name`. Options `fixCasing`, `stripLeadingThe`
(default true), `stripDescriptors` (default false), `ai` (true runs the model
step on names the rules leave unsure; it degrades to the rules result with
`ai.skipped` when its daily limit or budget is spent).
- person_name: `names` or `name`, `removeDiacritics`. Splits first, middle and
last; non-names come back with isPerson false.
- job_title: `titles` or `title`, `ai`. Clean title, short title, seniority and
department; `needsModel` marks titles no rule matched.
- domain: `values` or `value`: URLs, emails, domains or LinkedIn company URLs to
their registrable domain, with freemail flagged.
- phone: `numbers` or `number`, `country`, `defaultCountry` (ISO2), `format`
(E.164, INTERNATIONAL, NATIONAL, RFC3966).
- rows: `rows` (1 to 100 objects, header to value), optional `columns` (Kenso field
to header, e.g. {"email": "Work Email"}), `clean`, `dedupeBy`, `remove`, `add`,
`ai`. Every cleaner in one pass, dedupe within the call, flags per row.
Example:
free_tools(operation="clean", kind="company_name", input={"names": ["ACME LOGISTICS LLC", "The Home Depot, Inc."]})
dns_lookup
Read.
Look up DNS records for a name, or PTR for an IP, from ken.so.
`input`: `name` (a name or IP, or a list of up to 100), `type` (list of A, AAAA,
MX, TXT, CNAME, NS, SOA, PTR; default every type but PTR), `resolvers` ("all"
asks Cloudflare, Google, Quad9 and OpenDNS and counts as 4 lookups; it needs
exactly one type). Returns the API's JSON with `source_url`.
Example:
free_tools(operation="dns_lookup", input={"name": "acme.com", "type": ["MX", "TXT"]})
generate_dns_record
Read.
Generate an SPF, DMARC, BIMI, MTA-STS or TLS-RPT record to paste into DNS.
Record generators, no DNS lookups. Check the live record with
free_tools(operation="check_domain", kind="spf", input={"domain": "acme.com"})
after you publish. DKIM keys are not generated here: a private key made on a
server is a key someone else has seen. Returns the API's JSON with `source_url`.
Kinds and their `input`:
- spf: `domain`, `senders` (sender ids such as google, microsoft, ken, zoho,
sendgrid, mailgun, amazon_ses, hubspot; an unknown id lists them all);
`includes`, `ip4`, `ip6`, `mx`, `a`, `all` ("-" or "~", default "~").
- dmarc: `domain`, `policy` (none, quarantine, reject); `rua`, `ruf`,
`subdomainPolicy`, `adkim`, `aspf`, `fo`.
- bimi: `domain`, `logoUrl` (HTTPS SVG Tiny PS); `certificateUrl`, `selector`.
- mta_sts: `domain`, `mx` (the MX hosts); `mode` (default testing), `maxAge`.
- tls_rpt: `domain`, `rua` (1 to 5 mailto or HTTPS targets).
Example:
free_tools(operation="generate_dns_record", kind="dmarc", input={"domain": "acme.com", "policy": "quarantine", "rua": ["dmarc@acme.com"]})
smtp_test
Read.
Test a mail server's SMTP setup from Kenso's probe box. It never sends a message.
`input`: `domain` (tests its first MX host) or `host` (hostname or IPv4), not
both; `port` (25, 465 or 587, default 25). Banner, EHLO, STARTTLS, the
certificate, reverse DNS and timings, with the transcript. 10 tests a day per
Kenso account and 5 a day against any one host. Returns the API's JSON with
`source_url`.
Example:
free_tools(operation="smtp_test", input={"domain": "acme.com"})
spintax
Read.
Validate, count, expand, convert or suggest spintax.
The ken.so spintax tools. `syntax` is the dialect: plain ({a|b}, the default),
smartlead, instantly, lemlist, saleshandy or reply. Returns the API's JSON
with `source_url`.
Kinds and their `input`:
- validate: `template`, `syntax`. Errors and warnings with line and column.
- count: `template`, `syntax`. Exact count as a decimal string.
- expand: `template`, `syntax`, `count` (versions, default 10), `seed`,
`unique` (default true).
- convert: `template`, `from`, `to` (dialects).
- suggest: `text` (plain copy), `syntax`. Spins from Kenso's phrase bank, no AI.
Example:
free_tools(operation="spintax", kind="expand", input={"template": "{Hi|Hey} {{first_name}}", "count": 2})