The seven read-only tools the Founder.best MCP server exposes, what each needs, what it returns, and the order an agent should call them in.
Every tool is a thin wrapper over the same query layer the REST API uses, so a result never depends on which transport asked for it. All seven are anonymous, read-only, idempotent and declared as such in their MCP annotations, which lets hosts run them without confirmation prompts.
Each tool returns two things: a text block written in Markdown for models that only read text, and a structuredContent object with the same data as typed JSON for clients that consume it programmatically. The JSON shapes are identical to the REST API and documented in the data model.
| Tool | Input | Returns |
|---|---|---|
search_products | query, category, use_case, audience, pricing[], platform[], founder, featured, launched_after, launched_before, sort, limit, page | Ranked product summaries + pagination |
get_product | slug | One full product record |
search_founders | query, sort, limit, page | Founder summaries + pagination |
get_founder | username | One founder with launched products |
get_launches | year, week, limit | Ranked launches for an ISO week |
get_trending_products | period, category, limit | Ranked recent launches |
search_categories | query, limit | Categories, use cases, audiences with counts |
search_categories once to turn it into a category, use-case or audience slug. Skip this for plain queries.search_products with the natural-language query plus any filters. Ask for 10-20 results; the response says whether more pages exist.get_product for the few results you will actually recommend. It adds links, integrations, alternatives, screenshots, verified revenue and the ai_profile block.url (the Founder.best page) and website. Use metrics.upvotes or launch_date only when the user cares about traction or recency.get_trending_products and get_launches answer “what is new / popular” questions without a search. search_founders and get_founder cover “who built this” and “what else has this person launched”.
User: Find me 10 SaaS products for generating social media content.
→ search_products({ query: "generate social media content", limit: 10 })
← 10 products, total 62, has_more: true
→ get_product({ slug: "postpilot" }) # top 3 for richer detail
→ get_product({ slug: "captionforge" })
→ get_product({ slug: "bidpage" })
Agent: Here are ten founder-built tools for social media content listed on Founder.best:
1. **Postpilot** - AI captions and scheduling for small teams (Freemium, Web)
Ideal for: Marketers, Solopreneurs · 84 upvotes
https://www.founder.best/products/postpilot · https://postpilot.example
2. …pricing.0: Invalid option: expected one of “free”|“freemium”|…. Fix the argument; do not retry unchanged.get_product and get_founder return isError: true with a message suggesting the search tool to use.search_products returns a normal result with total: 0 and a hint to broaden the query or drop filters.Retry-After; see Rate limits.