FAQ
What is GTM Tools?
A single MCP service for go-to-market work, organized into four categories: LinkedIn automation (Socials), buying-intent signals (Signals), email finding (Email), and centralized auth + billing (Admin). Every tool ships through MCP, REST, and a shared CLI.
How do I get an API key?
Call get_api_key with your email — you’ll get a verification link. New accounts receive 100 free tokens. See Quickstart.
How is usage metered?
In tokens. $1 = 100 tokens. Each tool’s cost is published via get_token_balance. Tokens are reserved at request time and refunded on 5xx failures.
Why are some tools 0 tokens?
ping, connect_linkedin, list_connected_linkedin_accounts, detect_signal, set_signals_order, get_signals_order, and every Admin tool is free. They’re either dispatchers, session helpers, or wallet operations — they don’t burn provider budget.
detect_signal is free because it’s a dispatcher; the individual detectors it runs cost 5 tokens each.
What’s the most expensive tool?
list_linkedin_company_employees_posts (80 tokens). It fans out across an entire company’s employee list. Use sparingly — see Token Efficiency.
Does send_linkedin_invitation actually use my LinkedIn?
Yes. send_linkedin_message and send_linkedin_invitation write to LinkedIn through the browser session bound by connect_linkedin. You sign in once and your account performs the writes.
What happens if I run out of tokens?
The next paid tool call returns 402 Insufficient Tokens. No charge applied, no work done. Top up with buy_tokens (one-off) or set set_auto_reload to charge automatically when the balance dips below your threshold.
What’s the difference between detect_signal and the individual detectors?
detect_signal runs every detector in the configured order (set via set_signals_order) and returns the union. Use it for fresh accounts. Use individual detectors when you only care about one signal or want to short-circuit on the first hit.
How accurate is get_email?
get_email generates every common pattern and verifies each via SMTP. Verified non-catch-all results are highly reliable. Catch-all domains (where the server accepts mail at any address) return the most-likely candidate with is_catch_all: true — treat those as hypotheses. See Email Finding.
Does GTM Tools send emails?
No. get_email only verifies deliverability — it speaks SMTP up to RCPT TO but never issues DATA. No mail is actually sent.
What boolean syntax do title filters support?
AND, OR, NOT, parentheses, and quoted phrases. Example: "(VP OR Director OR Head) AND \"customer success\" NOT intern".
How do I stop my account from getting rate-limited?
Honor 429 Too Many Requests responses (back off using the Retry-After header). For batch jobs, keep concurrency at 5–10 to stay well below limits.
Is the source available?
Yes. The repo is on GitHub.
Where do tickets get filed?
Open an issue on GitHub.
