search_founders

Find founders by name, username, headline or bio, ranked by community upvotes, products, followers or recency.

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

querystring

Name, username, or words from their headline / bio. Up to 120 characters.

sortstringdefault upvotes

upvotes, products, followers or newest.

limitintegerdefault 10

Maximum results to return, 1-100.

pageintegerdefault 1

1-based page number. The response includes has_more; increment while it is true.

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

Prompt

Which founders on Founder.best are building analytics tools?

The agent calls the tool:

tools/call arguments

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

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

structuredContent

{
  "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

GEThttps://www.founder.best/api/v1/founders?search=…&sort=upvotes&limit=10