# GTM Tools | Docs

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://gtm-tools.sh/_mcp/server

## Docs

- [Welcome](https://gtm-tools.sh/welcome.md): Welcome to GTM Tools, your starting point for giving AI agents access to LinkedIn automation, signal detection, and email finding.
- [Introduction](https://gtm-tools.sh/introduction.md): MCP, REST, and CLI tools for LinkedIn automation, signal detection, email finding, and centralized auth + billing, metered in tokens and billed centrally.
- [Quickstart](https://gtm-tools.sh/quickstart.md): Two paths to get up and running with GTM Tools: programmatic signup for agents, or a terminal walkthrough for humans.
- [Billing Tools](https://gtm-tools.sh/billing-tools.md): The Billing category gets API keys, tracks token balances, charges cards, and exposes invoice history. Every paid tool consults this layer to authorize requests and meter usage.
- [LinkedIn Tools](https://gtm-tools.sh/socials-tools.md): 19 tools for searching companies, resolving people, fetching posts and jobs, listing employees with boolean title filters, and sending DMs and invitations.
- [Reddit Tools](https://gtm-tools.sh/reddit-tools.md): 21 tools covering the full Reddit-engagement loop: search posts + subreddits, list hot/new/rising, check posting rules, evaluate users, save / follow / subscribe, manage custom feeds (multireddits), post and comment, vote, read the inbox, and DM via Reddit's chat system (Matrix-based).
- [Email Tools](https://gtm-tools.sh/email-tools.md): get_email generates every common email pattern for a person and verifies each against the domain's mail server via SMTP. No mail is actually sent.
- [Signals Tools](https://gtm-tools.sh/signals-tools.md): detect_signal fans out to every detector for a domain. Configurable execution order lets you front-load the cheapest, highest-confidence signals.
- [Agent Onboarding](https://gtm-tools.sh/integrations/agent-onboarding.md): Resources for AI coding assistants: MCP server, agent-friendly docs, and a single bearer token to LinkedIn, Reddit, email, and signal tools.
- [MCP](https://gtm-tools.sh/integrations/mcp.md): Streamable HTTP MCP endpoint with OAuth-first authentication. Wire it into Claude Desktop, Cursor, Windsurf, and any other MCP client.
- [CLI](https://gtm-tools.sh/integrations/cli.md): gtm-tools is a single npm-installable binary that fronts every tool through one bearer token. Namespaces: admin, socials, reddit, email, signals, mcp, extension, update.
- [Browser extension (internal)](https://gtm-tools.sh/extension.md): Install and connect the GTM Tools browser extension to share workspace sessions used by enrichment tools.
- [OpenClaw](https://gtm-tools.sh/integrations/openclaw.md): Give an OpenClaw agent LinkedIn automation, Reddit engagement, buying signals, and verified emails, either through the official gtm-tools skill or the hosted MCP server.
- [Hermes Agent](https://gtm-tools.sh/integrations/hermes.md): Give Nous Research's Hermes Agent LinkedIn automation, Reddit engagement, buying signals, and verified emails, either through the official gtm-tools skill or the hosted MCP server.
- [Google ADK](https://gtm-tools.sh/integrations/google-adk.md): Connect a Google ADK agent to the GTM Tools MCP server so it can qualify accounts on buying signals, find decision-makers on LinkedIn, and verify professional emails.
- [LangChain](https://gtm-tools.sh/integrations/langchain.md): Load every GTM Tools tool into a LangChain or LangGraph agent through langchain-mcp-adapters, with buying signals, LinkedIn lookup, and verified emails as standard LangChain tools.
- [Eve](https://gtm-tools.sh/integrations/eve.md): Add GTM Tools to a Vercel Eve agent as the official skill or an MCP connection, with approval gates on the LinkedIn and Reddit write tools.
- [Outbound Sales](https://gtm-tools.sh/skills/outbound-sales.md): Install the gtm-skills bundle with one command. The `outbound-sales` sub-skill runs buying-intent signals on target domains, maps each firing signal to a message angle + title filter, finds the decision-maker, verifies the email, and drafts BOTH a cold email AND a LinkedIn DM keyed to the firing signal. Returns structured drafts ready to paste into Apollo / Outreach / Salesloft / Lemlist / Smartlead / your CRM. Does not send; handoff only.
- [LinkedIn Copywriter](https://gtm-tools.sh/skills/linkedin-copywriter.md): Install the gtm-skills bundle into Claude Code (or any Agent Skills-compatible client) with one command. Includes the `linkedin-copywriter` sub-skill, which reads your recent posts to learn your voice, fetches context for the target post or profile, drafts in your style, scrubs em dashes / banned vocabulary / sycophantic openers / rule-of-three constructions, and returns copy-paste-ready output. Four modes (post / comment / invitation / dm), per-mode char limits, draft-then-paste by default.
- [Reddit Community Manager](https://gtm-tools.sh/skills/reddit-community-manager.md): Install the gtm-skills bundle into Claude Code (or any Agent Skills-compatible client) with one command. Includes the `reddit-community-manager` sub-skill, which teaches an agent to discover relevant threads, qualify posters, draft and post comments that don't read as AI spam, DM users, and follow up, using the should-I-reply gate, anti-AI-spam style rules, and disclosure pattern that actually works on Reddit.
- [Outbound](https://gtm-tools.sh/outbound.md): Outbound as a proper acquisition channel: signal-keyed timing (right time), persona resolution by signal (right person), signal-driven angles (right message). How the three levers compound, channel economics vs. paid + content, hygiene rules that actually matter, and how the outbound-sales skill operationalizes the whole pipeline.
- [Results Ranking Optimization](https://gtm-tools.sh/results-ranking.md): The acquisition channel that captures buyers asking questions about your category: on Google (SEO), in answer engines like Perplexity (AEO), and inside LLM outputs from ChatGPT / Claude / Gemini (GEO). Reddit is the highest-leverage surface for all three. How to use the reddit-community-manager skill to build durable rankings, brand mentions, and LLM citations.
- [Tool Selection](https://gtm-tools.sh/tool-selection.md): Decision flows for choosing between GTM Tools' 60+ tools so your agent doesn't burn tokens on calls it doesn't need.
- [Token Efficiency](https://gtm-tools.sh/token-efficiency.md): Qualify before prospecting, lean on free tools, cache stable lookups, and pick cheap detectors first. The patterns that keep token spend in check.
- [Lead Enrichment](https://gtm-tools.sh/lead-enrichment.md): Take a CSV of name + company_domain rows and enrich each with the LinkedIn profile URL and verified professional email.
- [Signal Pipeline](https://gtm-tools.sh/signal-pipeline.md): Run detect_signal across a target account list, weight the fired signals, and emit the top-N accounts as a daily digest.
- [Frequently Asked Questions](https://gtm-tools.sh/faq.md): Frequently asked questions about GTM Tools: getting an API key, how tokens work, what happens on failure, and more.
- [Error Reference](https://gtm-tools.sh/errors.md): Every GTM Tools HTTP error code (400, 401, 402, 404, 405, 429, 5xx), what it means, and how to recover.
- [Join the GTM Tools Community](https://gtm-tools.sh/community.md): Follow GTM Tools on LinkedIn and X for product updates, and reach out for premium support.
- [Support](https://gtm-tools.sh/support.md): Contact GTM Tools support at support@gtm-tools.sh for help with your account, billing, or any tool.
- [Pricing](https://gtm-tools.sh/pricing.md): GTM Tools pricing: the token cost of every tool. $1 = 100 tokens, new accounts start with 100 free tokens, and the cost is debited when a tool runs.
- [Knowledge Base](https://gtm-tools.sh/knowledge-base/introduction.md): Concepts, agent patterns, and troubleshooting for GTM Tools
- [What is GTM Tools?](https://gtm-tools.sh/knowledge-base/getting-started/what-is-gtm-tools.md): The platform in one page
- [Getting Your API Key](https://gtm-tools.sh/knowledge-base/getting-started/getting-api-key.md): Get a key, verify the email, and start calling tools
- [How Tokens Work](https://gtm-tools.sh/knowledge-base/getting-started/how-tokens-work.md): How GTM Tools meters paid calls: the metering gate, which failures charge tokens, and what to do when you run out
- [What are the rate limits?](https://gtm-tools.sh/knowledge-base/getting-started/rate-limits.md): GTM Tools applies no per-workspace rate limits. Where 429s actually come from, safe concurrency for batch jobs, and how to handle Retry-After.
- [Outbound Sales Flow](https://gtm-tools.sh/knowledge-base/agent-patterns/outbound-sales-flow.md): End-to-end pattern: domain → signals → decision-maker → email → outreach
- [Signal-Driven Outreach](https://gtm-tools.sh/knowledge-base/agent-patterns/signal-driven-outreach.md): Start from a signal, work backwards to the right person and the right message
- [How do I keep a human in the loop?](https://gtm-tools.sh/knowledge-base/agent-patterns/human-in-the-loop.md): Which GTM Tools calls produce something a real person sees, why LinkedIn posts are draft-only, and how to gate sends with skill rules or runtime approval policies.
- [How do I track engagement state?](https://gtm-tools.sh/knowledge-base/agent-patterns/tracking-state.md): Use save_reddit_thing categories and custom feeds as agent workflow state, check conversation history before a second DM, and understand what GTM Tools does not remember for you.
- [401 Unauthorized](https://gtm-tools.sh/knowledge-base/troubleshooting/unauthorized.md): Bearer token issues and how to fix them
- [402 Insufficient Tokens](https://gtm-tools.sh/knowledge-base/troubleshooting/insufficient-tokens.md): What to do when the wallet runs dry
- [LinkedIn Session Expired](https://gtm-tools.sh/knowledge-base/troubleshooting/linkedin-session.md): Reconnecting after a session times out
- [Why is get_email returning not_found?](https://gtm-tools.sh/knowledge-base/troubleshooting/email-not-found.md): get_email returns a reason on every non-ok result. What catch_all, no_mx, unverifiable_provider, no_pattern_verified, and smtp_blocked each mean, and what to do about them.
- [Why did I get try_again_later?](https://gtm-tools.sh/knowledge-base/troubleshooting/try-again-later.md): try_again_later is the transient signal from get_email and get_coordinates. It maps to HTTP 429 with Retry-After, it is charged, and each retry charges again.
- [Why is employee search returning fewer people than expected?](https://gtm-tools.sh/knowledge-base/troubleshooting/employee-search-results.md): Debugging list_linkedin_company_employees and search_linkedin_company_employees: filter syntax, the difference between the two tools, and why pagination doesn't change the price.
- [GTM Tools Changelog](https://gtm-tools.sh/changelog/changelog.md)

## API Docs

- API Reference > Billing [Get an API key via email verification](https://gtm-tools.sh/api-reference/api-reference/billing/get-api-key.md)
- API Reference > Billing [Check token balance and per-tool costs](https://gtm-tools.sh/api-reference/api-reference/billing/get-token-balance.md)
- API Reference > Billing [Charge a saved card and credit tokens](https://gtm-tools.sh/api-reference/api-reference/billing/buy-tokens.md)
- API Reference > Billing [Configure automatic balance top-ups](https://gtm-tools.sh/api-reference/api-reference/billing/set-auto-reload.md)
- API Reference > Billing [Charge / refund history](https://gtm-tools.sh/api-reference/api-reference/billing/list-invoices.md)
- API Reference > LinkedIn [List connected LinkedIn accounts](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-connected-linkedin-accounts.md)
- API Reference > LinkedIn [Find a company's LinkedIn page from a domain](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-company-url.md)
- API Reference > LinkedIn [Resolve a name + company domain to a profile URL](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-profile-url.md)
- API Reference > LinkedIn [Hydrate a LinkedIn profile](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-profile.md)
- API Reference > LinkedIn [Hydrate a LinkedIn company page](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-company.md)
- API Reference > LinkedIn [Search a company's employees with boolean title filters](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-company-employees.md)
- API Reference > LinkedIn [List recent posts from a company page](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-company-posts.md)
- API Reference > LinkedIn [Recent posts from a company's employees](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-company-employees-posts.md)
- API Reference > LinkedIn [List recent posts from a single profile](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-user-posts.md)
- API Reference > LinkedIn [Get full content for a single post](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-post.md)
- API Reference > LinkedIn [List people who reacted to a post](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-post-reactions.md)
- API Reference > LinkedIn [List comments on a post](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-post-comments.md)
- API Reference > LinkedIn [List jobs posted by a company](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-jobs.md)
- API Reference > LinkedIn [Get full details of a job listing](https://gtm-tools.sh/api-reference/api-reference/linked-in/get-linkedin-job.md)
- API Reference > LinkedIn [List saved posts (requires session)](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-saved-posts.md)
- API Reference > LinkedIn [List recent DM threads (requires session)](https://gtm-tools.sh/api-reference/api-reference/linked-in/list-linkedin-conversations.md)
- API Reference > LinkedIn [Send a direct message (requires session)](https://gtm-tools.sh/api-reference/api-reference/linked-in/send-linkedin-message.md)
- API Reference > LinkedIn [Send a connection request (requires session)](https://gtm-tools.sh/api-reference/api-reference/linked-in/send-linkedin-invitation.md)
- API Reference > Reddit [List connected Reddit accounts](https://gtm-tools.sh/api-reference/api-reference/reddit/list-connected-reddit-accounts.md)
- API Reference > Reddit [Search Reddit posts by keyword](https://gtm-tools.sh/api-reference/api-reference/reddit/search-reddit-posts.md)
- API Reference > Reddit [List posts from a subreddit by sort order](https://gtm-tools.sh/api-reference/api-reference/reddit/list-subreddit-posts.md)
- API Reference > Reddit [Search subreddits by name or description](https://gtm-tools.sh/api-reference/api-reference/reddit/search-reddit-subreddits.md)
- API Reference > Reddit [Get a subreddit's metadata and rules](https://gtm-tools.sh/api-reference/api-reference/reddit/get-subreddit-about.md)
- API Reference > Reddit [Get a Reddit post and its full comment tree](https://gtm-tools.sh/api-reference/api-reference/reddit/get-reddit-post.md)
- API Reference > Reddit [Get a Reddit user's karma + account age + verified flags](https://gtm-tools.sh/api-reference/api-reference/reddit/get-reddit-user.md)
- API Reference > Reddit [List a user's recent posts and/or comments](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-user-posts.md)
- API Reference > Reddit [Reply to a Reddit post or comment](https://gtm-tools.sh/api-reference/api-reference/reddit/create-reddit-comment.md)
- API Reference > Reddit [Submit a new post to a subreddit (text or link)](https://gtm-tools.sh/api-reference/api-reference/reddit/create-reddit-post.md)
- API Reference > Reddit [Upvote, downvote, or clear a vote](https://gtm-tools.sh/api-reference/api-reference/reddit/vote-reddit.md)
- API Reference > Reddit [DM a user via Reddit Chat (Matrix-based)](https://gtm-tools.sh/api-reference/api-reference/reddit/send-reddit-message.md)
- API Reference > Reddit [Follow / unfollow a Reddit post for new-comment notifications](https://gtm-tools.sh/api-reference/api-reference/reddit/follow-reddit-post.md)
- API Reference > Reddit [Save / unsave a Reddit post or comment](https://gtm-tools.sh/api-reference/api-reference/reddit/save-reddit-thing.md)
- API Reference > Reddit [List saved posts and comments (the engagement queue)](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-saved.md)
- API Reference > Reddit [Read DMs, comment replies, post replies, and mentions](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-inbox.md)
- API Reference > Reddit [Bulk subscribe or unsubscribe to subreddits](https://gtm-tools.sh/api-reference/api-reference/reddit/subscribe-reddit-subreddit.md)
- API Reference > Reddit [List subscribed subreddits](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-subscriptions.md)
- API Reference > Reddit [List the connected account's custom feeds (multireddits)](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-custom-feeds.md)
- API Reference > Reddit [List posts from a custom feed, merged across all its subreddits](https://gtm-tools.sh/api-reference/api-reference/reddit/list-reddit-custom-feed-posts.md)
- API Reference > Reddit [Create a custom feed (multireddit) from a list of subreddits](https://gtm-tools.sh/api-reference/api-reference/reddit/create-reddit-custom-feed.md)
- API Reference > Email [Find a person's professional email (SMTP-verified)](https://gtm-tools.sh/api-reference/api-reference/email/get-email.md)
- API Reference > Geocoding [Get coordinates (lat/lng) for a free-text location](https://gtm-tools.sh/api-reference/api-reference/geocoding/get-coordinates.md)
- API Reference > Signals [Run every signal detector for a domain](https://gtm-tools.sh/api-reference/api-reference/signals/detect-signal.md)
- API Reference > Signals [Detect Instagram/TikTok follower spikes](https://gtm-tools.sh/api-reference/api-reference/signals/signal-socials-spike.md)
- API Reference > Signals [Detect hiring for a specific role](https://gtm-tools.sh/api-reference/api-reference/signals/signal-hiring-role.md)
- API Reference > Signals [Detect CX/support hiring](https://gtm-tools.sh/api-reference/api-reference/signals/signal-hiring-support.md)
- API Reference > Signals [Detect SDR/BDR hiring](https://gtm-tools.sh/api-reference/api-reference/signals/signal-hiring-sales-rep.md)
- API Reference > Signals [Detect sales leadership hiring](https://gtm-tools.sh/api-reference/api-reference/signals/signal-hiring-sales-leadership.md)
- API Reference > Signals [Detect reposted SDR roles (churn signal)](https://gtm-tools.sh/api-reference/api-reference/signals/signal-hiring-sales-rep-repost.md)
- API Reference > Signals [Detect recent negative Trustpilot reviews](https://gtm-tools.sh/api-reference/api-reference/signals/signal-trustpilot-negative-reviews.md)
- API Reference > Signals [Detect negative Trustpilot reviews mentioning support](https://gtm-tools.sh/api-reference/api-reference/signals/signal-trustpilot-negative-support-reviews.md)
- API Reference > Signals [Detect recent positive Trustpilot reviews](https://gtm-tools.sh/api-reference/api-reference/signals/signal-trustpilot-positive-reviews.md)
- API Reference > Signals [Detect technology identifiers on a website](https://gtm-tools.sh/api-reference/api-reference/signals/signal-technologies-identified.md)
- API Reference > Signals [Configure signal execution order](https://gtm-tools.sh/api-reference/api-reference/signals/set-signals-order.md)
- API Reference > Signals [View the current signal execution order](https://gtm-tools.sh/api-reference/api-reference/signals/get-signals-order.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://gtm-tools.sh/openapi.json)
- [OpenAPI YAML](https://gtm-tools.sh/openapi.yaml)