Job title normalization API
normalize_title
0.1 credits / callNormalize a free-text job title ("sdr", "head of eng", "vp sales") into canonical title strings plus a seniority and function guess. Titles resolve against the live title vocabulary (abbreviation-aware, typo-tolerant) layered over a curated shorthand map. Seniority values: owner, cxo, vp, director, manager, senior, entry, training. Functions follow LinkedIn's function vocabulary (sales, marketing, engineering, ...).
Parameters
| param | type | description |
|---|---|---|
| title required | string | Job title text to normalize, e.g. "sdr", "head of eng", "growth marketer". |
Call it from your agent (MCP)
Connect once and normalize_title appears in your agent’s toolbox next to every other gtm.dev tool. Claude Code:
claude mcp add --transport http gtm https://mcp.gtm.dev \
--header "Authorization: Bearer YOUR_API_KEY"Under the hood, the client sends:
curl -X POST https://mcp.gtm.dev \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"normalize_title","arguments":{"title":"head of eng"}}}'other clients (cursor, claude desktop, openai agents sdk, langchain): mcp setup
Call it over REST
curl -X POST https://api.gtm.dev/v1/tools/normalize_title \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"head of eng"}'Errors (401, 402, 429, 400) are listed in the REST reference. Calls that error are not billed — see pricing.