search_founders

Auth

None

Side effects

None (read-only)

Returns

text + structuredContent

Finds founders with a completed public profile. The query matches name, username, headline and bio. Without a query you get the community leaderboard ordered by upvotes received. Only public fields are returned - never email addresses, billing details or private settings.

Parameters

Response

structuredContent contains total, page, has_more and a founders array of founder summaries: username, name, headline, url, api_url, markdown_url, avatar_url, product_count (live products, recomputed), total_upvotes_received, follower_count.

Example

Which founders on Founder.best are building analytics tools?

The agent calls the tool:

{ "name": "search_founders", "arguments": { "query": "analytics", "limit": 5 } }

and gets back Markdown for the model plus structuredContent shaped like this (trimmed):

{
  "total": 3,
  "page": 1,
  "has_more": false,
  "founders": [
    {
      "type": "founder",
      "username": "janedoe",
      "name": "Jane Doe",
      "headline": "Building Acme Analytics",
      "url": "https://www.founder.best/founders/janedoe",
      "api_url": "https://www.founder.best/api/v1/founders/janedoe",
      "markdown_url": "https://www.founder.best/founders/janedoe.md",
      "avatar_url": "https://cdn.founder.best/avatars/janedoe.png",
      "product_count": 2,
      "total_upvotes_received": 140,
      "follower_count": 18
    }
  ]
}

Notes

• url points at the founder’s canonical page, which is /founders/<username> or a vanity /<username> for Founder Profile subscribers.

REST equivalent