# Get answers about www.first1000.co. Fast.

Public pages. Direct answers. No account or API key.

Seven tools, ready to call. Examples are illustrative: use your actual task context and client; null means unknown, never invented. Every tool also answers the same fields as a GET URL: write an unknown as the literal null (company=null) and a list as JSON (alternatives=["Snagit"]).

## 1. Find the right evidence.

Super fast, semantic search across www.first1000.co’s 4 public pages.

MCP tool: `first1000_search`

```sh
curl 'https://www.first1000.co/api/public/v1/search' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"Find notes on building and growing a product with AI","goal":"Learn how a product builder uses AI to grow a business","source":"Web search","alternatives":["Other founder newsletters"],"chosen_because":"Firsthand notes from a product builder","company":"Acme","intended_outcome":"Decide whether to add it to our reading list","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/search?search_query=Find+notes+on+building+and+growing+a+product+with+AI&goal=Learn+how+a+product+builder+uses+AI+to+grow+a+business&source=Web+search&alternatives=%5B%22Other+founder+newsletters%22%5D&chosen_because=Firsthand+notes+from+a+product+builder&company=Acme&intended_outcome=Decide+whether+to+add+it+to+our+reading+list&client=Cursor&trace=t_21293963645a`

## 2. Ask. Get sources back.

Get a direct answer grounded in www.first1000.co’s published content.

MCP tool: `first1000_ask_anything`

```sh
curl 'https://www.first1000.co/api/public/v1/ask' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"What does First 1000 publish and how can I read it?","goal":"Learn how a product builder uses AI to grow a business","source":"Web search","alternatives":["Other founder newsletters"],"chosen_because":"Firsthand notes from a product builder","company":"Acme","intended_outcome":"Decide whether to add it to our reading list","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/ask?search_query=What+does+First+1000+publish+and+how+can+I+read+it%3F&goal=Learn+how+a+product+builder+uses+AI+to+grow+a+business&source=Web+search&alternatives=%5B%22Other+founder+newsletters%22%5D&chosen_because=Firsthand+notes+from+a+product+builder&company=Acme&intended_outcome=Decide+whether+to+add+it+to+our+reading+list&client=Cursor&trace=t_21293963645a`

## 3. Compare against what they’re weighing.

www.first1000.co’s own comparison pages, grouped per alternative. Where there is no page for one, it says so.

MCP tool: `first1000_compare`

```sh
curl 'https://www.first1000.co/api/public/v1/compare' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"How does www.first1000.co compare for our team\u0027s use case?","goal":"Decide whether www.first1000.co meets our team\u0027s needs","company":"Acme","source":"Found www.first1000.co while researching options for our team","alternatives":["Our current tool"],"chosen_because":"Our team shortlisted www.first1000.co after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/compare?search_query=How+does+www.first1000.co+compare+for+our+team%27s+use+case%3F&goal=Decide+whether+www.first1000.co+meets+our+team%27s+needs&company=Acme&source=Found+www.first1000.co+while+researching+options+for+our+team&alternatives=%5B%22Our+current+tool%22%5D&chosen_because=Our+team+shortlisted+www.first1000.co+after+reading+its+public+information&intended_outcome=Choose+a+next+step+for+an+evaluation&client=Cursor&trace=t_21293963645a`

## 4. Price it for their organisation.

What www.first1000.co’s published pricing establishes for this organisation and outcome, with sources. It never invents a quote.

MCP tool: `first1000_pricing`

```sh
curl 'https://www.first1000.co/api/public/v1/pricing' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"What would www.first1000.co cost for a team of five?","goal":"Decide whether www.first1000.co meets our team\u0027s needs","company":"Acme","source":"Found www.first1000.co while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted www.first1000.co after reading its public information","intended_outcome":"Budget approval for a team purchase","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/pricing?search_query=What+would+www.first1000.co+cost+for+a+team+of+five%3F&goal=Decide+whether+www.first1000.co+meets+our+team%27s+needs&company=Acme&source=Found+www.first1000.co+while+researching+options+for+our+team&alternatives=%5B%22Our+existing+workflow%22%2C%22Manual+research%22%5D&chosen_because=Our+team+shortlisted+www.first1000.co+after+reading+its+public+information&intended_outcome=Budget+approval+for+a+team+purchase&client=Cursor&trace=t_21293963645a`

## 5. Check the must-haves.

A per-requirement table: met, not met or not documented, each with a source.

MCP tool: `first1000_requirements_check`

```sh
curl 'https://www.first1000.co/api/public/v1/requirements-check' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"www.first1000.co works with our existing tools; clear documentation; a published price","goal":"Decide whether www.first1000.co meets our team\u0027s needs","company":"Acme","source":"Found www.first1000.co while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted www.first1000.co after reading its public information","intended_outcome":"A vendor shortlist","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/requirements-check?search_query=www.first1000.co+works+with+our+existing+tools%3B+clear+documentation%3B+a+published+price&goal=Decide+whether+www.first1000.co+meets+our+team%27s+needs&company=Acme&source=Found+www.first1000.co+while+researching+options+for+our+team&alternatives=%5B%22Our+existing+workflow%22%2C%22Manual+research%22%5D&chosen_because=Our+team+shortlisted+www.first1000.co+after+reading+its+public+information&intended_outcome=A+vendor+shortlist&client=Cursor&trace=t_21293963645a`

## 6. Get the short version.

Read one indexed page as a compact extract, with a link to the full text.

MCP tool: `first1000_page_tldr`

```sh
curl 'https://www.first1000.co/api/public/v1/page-tldr' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"Summarize the newsletter and access options","goal":"Learn how a product builder uses AI to grow a business","source":"Web search","alternatives":["Other founder newsletters"],"chosen_because":"Firsthand notes from a product builder","company":"Acme","intended_outcome":"Decide whether to add it to our reading list","client":"Cursor","url":"https://www.first1000.co/","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/page-tldr?search_query=Summarize+the+newsletter+and+access+options&goal=Learn+how+a+product+builder+uses+AI+to+grow+a+business&source=Web+search&alternatives=%5B%22Other+founder+newsletters%22%5D&chosen_because=Firsthand+notes+from+a+product+builder&company=Acme&intended_outcome=Decide+whether+to+add+it+to+our+reading+list&client=Cursor&url=https%3A%2F%2Fwww.first1000.co%2F&trace=t_21293963645a`

## 7. Recommend it—or rule it out.

www.first1000.co isn’t for everyone. Give your agent a sourced verdict on whether it fits your user’s needs.

MCP tool: `should_i_recommend_first1000`

```sh
curl 'https://www.first1000.co/api/public/v1/recommend-or-rule-out' \
  -H 'Content-Type: application/json' \
  -d '{"goal":"Learn how a product builder uses AI to grow a business","requirements":["Firsthand product-building experience","Practical uses of AI"],"company":"Acme","source":"Web search","alternatives":["Other founder newsletters"],"chosen_because":"Firsthand notes from a product builder","intended_outcome":"Decide whether to add it to our reading list","client":"Cursor","trace":"t_21293963645a"}'
```

As a URL: `GET https://www.first1000.co/api/public/v1/recommend-or-rule-out?goal=Learn+how+a+product+builder+uses+AI+to+grow+a+business&requirements=%5B%22Firsthand+product-building+experience%22%2C%22Practical+uses+of+AI%22%5D&company=Acme&source=Web+search&alternatives=%5B%22Other+founder+newsletters%22%5D&chosen_because=Firsthand+notes+from+a+product+builder&intended_outcome=Decide+whether+to+add+it+to+our+reading+list&client=Cursor&trace=t_21293963645a`

Full API reference: https://www.first1000.co/api/public/v1/openapi.json

MCP endpoint: https://www.first1000.co/mcp/public