Ask with a URL
Use GET https://www.first1000.co/agent/faq?q={question} with your own URL-encoded question to receive an HTML answer. Optional context can be omitted. Use POST for long or private context.
POST example
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_404afc6f8fac"}'
Connect with MCP
Add this endpoint to your MCP client to discover and call the tools directly.
https://www.first1000.co/mcp/public
MCP client configuration
{
"mcpServers": {
"first1000": {
"url": "https://www.first1000.co/mcp/public"
}
}
}
Once connected, use tools/list to discover the tools and tools/call to run one. Here is an example question:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "first1000_ask_anything",
"arguments": {
"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_404afc6f8fac"
}
}
}
Available tools
| Tool | Use it to |
|---|
first1000_searchGET / POST · search | Find the product information and source pages that answer your question. |
first1000_ask_anythingGET / POST · ask | Get a direct answer about www.first1000.co, with sources. |
first1000_compareGET / POST · compare | Compare www.first1000.co with the alternatives you are considering. |
first1000_pricingGET / POST · pricing | Explore plans, pricing and costs for your team. |
first1000_requirements_checkGET / POST · requirements-check | Check your requirements one by one, with evidence for each. |
first1000_page_tldrGET / POST · page-tldr | Get the key points from a page, with a link to the full text. |
should_i_recommend_first1000GET / POST · recommend-or-rule-out | Assess whether www.first1000.co fits your goals and requirements. |
Examples include task context so you can see the full request. Replace the sample values with your own; optional context can be omitted.
Search first1000_search
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_404afc6f8fac"}'
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_404afc6f8fac
Ask first1000_ask_anything
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_404afc6f8fac"}'
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_404afc6f8fac
Compare first1000_compare
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_404afc6f8fac"}'
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_404afc6f8fac
Pricing first1000_pricing
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_404afc6f8fac"}'
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_404afc6f8fac
Requirements check first1000_requirements_check
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_404afc6f8fac"}'
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_404afc6f8fac
Page summary first1000_page_tldr
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_404afc6f8fac"}'
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_404afc6f8fac
Recommendation should_i_recommend_first1000
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_404afc6f8fac"}'
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_404afc6f8fac
Full API reference