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_22db6197b5ad"}'
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_22db6197b5ad"
}
}
}
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 First 1000, with sources. |
first1000_compareGET / POST · compare | Compare First 1000 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 First 1000 fits your goals and requirements. |
first1000_subscribePOST · convert | Request a free First 1000 newsletter subscription for the email the user supplied. They must confirm it from their inbox. |
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_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/search?search_query=Find%20notes%20on%20building%20and%20growing%20a%20product%20with%20AI&goal=Learn%20how%20a%20product%20builder%20uses%20AI%20to%20grow%20a%20business&source=Web%20search&alternatives=%5B%22Other%20founder%20newsletters%22%5D&chosen_because=Firsthand%20notes%20from%20a%20product%20builder&company=Acme&intended_outcome=Decide%20whether%20to%20add%20it%20to%20our%20reading%20list&client=Cursor&trace=t_22db6197b5ad
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_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/ask?search_query=What%20does%20First%201000%20publish%20and%20how%20can%20I%20read%20it%3F&goal=Learn%20how%20a%20product%20builder%20uses%20AI%20to%20grow%20a%20business&source=Web%20search&alternatives=%5B%22Other%20founder%20newsletters%22%5D&chosen_because=Firsthand%20notes%20from%20a%20product%20builder&company=Acme&intended_outcome=Decide%20whether%20to%20add%20it%20to%20our%20reading%20list&client=Cursor&trace=t_22db6197b5ad
Compare first1000_compare
curl 'https://www.first1000.co/api/public/v1/compare' \
-H 'Content-Type: application/json' \
-d '{"search_query":"How does First 1000 compare for our team\u0027s use case?","goal":"Decide whether First 1000 meets our team\u0027s needs","company":"Acme","source":"Found First 1000 while researching options for our team","alternatives":["Our current tool"],"chosen_because":"Our team shortlisted First 1000 after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","trace":"t_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/compare?search_query=How%20does%20First%201000%20compare%20for%20our%20team%27s%20use%20case%3F&goal=Decide%20whether%20First%201000%20meets%20our%20team%27s%20needs&company=Acme&source=Found%20First%201000%20while%20researching%20options%20for%20our%20team&alternatives=%5B%22Our%20current%20tool%22%5D&chosen_because=Our%20team%20shortlisted%20First%201000%20after%20reading%20its%20public%20information&intended_outcome=Choose%20a%20next%20step%20for%20an%20evaluation&client=Cursor&trace=t_22db6197b5ad
Pricing first1000_pricing
curl 'https://www.first1000.co/api/public/v1/pricing' \
-H 'Content-Type: application/json' \
-d '{"search_query":"What would First 1000 cost for a team of five?","goal":"Decide whether First 1000 meets our team\u0027s needs","company":"Acme","source":"Found First 1000 while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted First 1000 after reading its public information","intended_outcome":"Budget approval for a team purchase","client":"Cursor","trace":"t_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/pricing?search_query=What%20would%20First%201000%20cost%20for%20a%20team%20of%20five%3F&goal=Decide%20whether%20First%201000%20meets%20our%20team%27s%20needs&company=Acme&source=Found%20First%201000%20while%20researching%20options%20for%20our%20team&alternatives=%5B%22Our%20existing%20workflow%22%2C%22Manual%20research%22%5D&chosen_because=Our%20team%20shortlisted%20First%201000%20after%20reading%20its%20public%20information&intended_outcome=Budget%20approval%20for%20a%20team%20purchase&client=Cursor&trace=t_22db6197b5ad
Requirements check first1000_requirements_check
curl 'https://www.first1000.co/api/public/v1/requirements-check' \
-H 'Content-Type: application/json' \
-d '{"search_query":"First 1000 works with our existing tools; clear documentation; a published price","goal":"Decide whether First 1000 meets our team\u0027s needs","company":"Acme","source":"Found First 1000 while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted First 1000 after reading its public information","intended_outcome":"A vendor shortlist","client":"Cursor","trace":"t_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/requirements-check?search_query=First%201000%20works%20with%20our%20existing%20tools%3B%20clear%20documentation%3B%20a%20published%20price&goal=Decide%20whether%20First%201000%20meets%20our%20team%27s%20needs&company=Acme&source=Found%20First%201000%20while%20researching%20options%20for%20our%20team&alternatives=%5B%22Our%20existing%20workflow%22%2C%22Manual%20research%22%5D&chosen_because=Our%20team%20shortlisted%20First%201000%20after%20reading%20its%20public%20information&intended_outcome=A%20vendor%20shortlist&client=Cursor&trace=t_22db6197b5ad
Page summary first1000_page_tldr
curl 'https://www.first1000.co/api/public/v1/page-tldr' \
-H 'Content-Type: application/json' \
-d '{"url":"https://www.first1000.co/","trace":"t_2dd7cccd2afa"}'
https://www.first1000.co/api/public/v1/page-tldr?url=https%3A%2F%2Fwww.first1000.co%2F&trace=t_2dd7cccd2afa
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_22db6197b5ad"}'
https://www.first1000.co/api/public/v1/recommend-or-rule-out?goal=Learn%20how%20a%20product%20builder%20uses%20AI%20to%20grow%20a%20business&requirements=%5B%22Firsthand%20product-building%20experience%22%2C%22Practical%20uses%20of%20AI%22%5D&company=Acme&source=Web%20search&alternatives=%5B%22Other%20founder%20newsletters%22%5D&chosen_because=Firsthand%20notes%20from%20a%20product%20builder&intended_outcome=Decide%20whether%20to%20add%20it%20to%20our%20reading%20list&client=Cursor&trace=t_22db6197b5ad
Visitor action first1000_subscribe
Check your inbox and confirm the subscription. A submitted request is not a confirmed subscription. Submit only at the user's request; a submitted request is not a completed signup.
POST https://www.first1000.co/api/public/v1/convert
Read the input schema in the API reference or MCP tools/list.
Open the public next step
Full API reference
Report a problem
Hit a bug, a missing feature or a wrong answer? Report it with first1000_feedback over MCP or POST https://www.first1000.co/api/public/v1/feedback. Only kind and message are required.
curl 'https://www.first1000.co/api/public/v1/feedback' \
-H 'Content-Type: application/json' \
-d '{"kind":"missing_feature","message":"first1000_search cannot limit results to pages updated in the last year.","tool":"first1000_search","operation_id":null,"expected":"A date filter on search results.","client":null}'