Find the answer you need.

Ask with a URL

Use GET https://surge.app/agents/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://surge.app/agents/api/public/v1/ask' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"What does Surge offer, who is it for, and what does it not cover?","goal":"Decide whether Surge meets our team\u0027s needs","company":"Acme","source":"Found Surge while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted Surge after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","trace":"t_6a12d1bc2b0f"}'

Connect with MCP

Add this endpoint to your MCP client to discover and call the tools directly.

https://surge.app/agents/mcp/public

MCP client configuration

{
  "mcpServers": {
    "surge": {
      "url": "https://surge.app/agents/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": "surge_ask_anything",
    "arguments": {
      "search_query": "What does Surge offer, who is it for, and what does it not cover?",
      "goal": "Decide whether Surge meets our team's needs",
      "company": "Acme",
      "source": "Found Surge while researching options for our team",
      "alternatives": [
        "Our existing workflow",
        "Manual research"
      ],
      "chosen_because": "Our team shortlisted Surge after reading its public information",
      "intended_outcome": "Choose a next step for an evaluation",
      "client": "Cursor",
      "trace": "t_6a12d1bc2b0f"
    }
  }
}

Available tools

Examples include task context so you can see the full request. Replace the sample values with your own; optional context can be omitted.

curl 'https://surge.app/agents/api/public/v1/search' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"What does Surge offer, who is it for, and what does it not cover?","goal":"Decide whether Surge meets our team\u0027s needs","company":"Acme","source":"Found Surge while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted Surge after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","trace":"t_6a12d1bc2b0f"}'

curl 'https://surge.app/agents/api/public/v1/ask' \
  -H 'Content-Type: application/json' \
  -d '{"search_query":"What does Surge offer, who is it for, and what does it not cover?","goal":"Decide whether Surge meets our team\u0027s needs","company":"Acme","source":"Found Surge while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted Surge after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","trace":"t_6a12d1bc2b0f"}'

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

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

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

curl 'https://surge.app/agents/api/public/v1/page-tldr' \
  -H 'Content-Type: application/json' \
  -d '{"url":"https://surge.app/","trace":"t_f28891a1ee27"}'

curl 'https://surge.app/agents/api/public/v1/recommend-or-rule-out' \
  -H 'Content-Type: application/json' \
  -d '{"goal":"Decide whether Surge meets our team\u0027s needs","company":"Acme","source":"Found Surge while researching options for our team","alternatives":["Our existing workflow","Manual research"],"chosen_because":"Our team shortlisted Surge after reading its public information","intended_outcome":"Choose a next step for an evaluation","client":"Cursor","requirements":["Relevant published capabilities","A clear way to evaluate the offering"],"trace":"t_6a12d1bc2b0f"}'

Full API reference

Report a problem

Hit a bug, a missing feature or a wrong answer? Report it with surge_feedback over MCP or POST https://surge.app/agents/api/public/v1/feedback. Only kind and message are required.

curl 'https://surge.app/agents/api/public/v1/feedback' \
  -H 'Content-Type: application/json' \
  -d '{"kind":"missing_feature","message":"surge_search cannot limit results to pages updated in the last year.","tool":"surge_search","operation_id":null,"expected":"A date filter on search results.","client":null}'

For assistants

Frequently asked questions

Have another question?