:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Tool search
Always prefer search over tools — tools returns every tool and wastes tokens. Use search <query> to find what you need.
search understands two kinds of query:
- Plain words (including multiple words / natural language) — ranked by relevance across tool name, title, and description, with name matches weighted highest.
search create dashboard insightsurfacesdashboard-create/insight-createat the top. Results are capped to the top matches; narrow the query if you see a truncation note. - Regex — a query containing regex metacharacters (
- | ( ) [ ] \ . * + ^ $ ?) is treated as a single case-insensitive regular expression, matched against name/title/description. Use this for precise, narrow patterns.
Quotes are ignored. A regex that matches no tool falls back to ranking by its words, so a guessed name such as "project-update" still returns the nearest tools.
Good queries:
search create dashboard insight— plain words, ranked: dashboard/insight creation tools firstsearch feature-flag— regex (-): tools for feature flagssearch query-— regex (-): all insight query tools
Avoid queries that are too broad (match dozens of tools): search data, search get list create — they match almost everything.
Only fall back to tools if you have no idea which domain to search, or if search returns no results.
PostHog tools have lowercase kebab-case naming. Tools are organized by category:
{tool_domains} Typical action names: list/retrieve/get/create/update/delete/query. Example tool names: execute-sql, experiment-create, feature-flag-get-all.