Skip to content
somm

API and MCP server

Give your own agent Somm's sponsorship judgment. Every answer carries receipts for the Qloo requests behind it and a link to the full report a person can check.

MCP

Streamable HTTP, no sign-in, rate-limited per address. Add it to any MCP client:

{
  "mcpServers": {
    "somm": { "url": "https://somm-494617981995.us-central1.run.app/mcp" }
  }
}
ToolArgumentsReturns
fan_fingerprintproperty_name, kind, entities[], market?Taste tags, age and gender lean, where fans concentrate, momentum, and what else they love, with receipts.
prospect_sponsorsproperty_name, kind, entities[], categories?, exclusives?Brands the fans over-index for in each category, scored and gated.
fit_scoreproperty_name, kind, entities[], brand, category, competitors?, current_sponsors?One brand against one property: score, verdict, reasons and evidence.
evaluate_offerbrand, category, competitors?, offer_textReads pasted offers as untrusted text and returns a verdict for each.

Under the hood Somm calls Qloo through Qloo's own MCP server (qloo mcp), and the Qloo API directly for search, tags and multi-brand Insights calls.

HTTP

POST/api/scoutStart a sponsor report. Body: { property } or { description }. Returns { runId }.
POST/api/diligenceStart an offer review. Body: { brand: { name, category, competitors }, offersText }.
GET/api/runs/:id/eventsServer-sent events: each step, each Qloo request, questions, and done.
GET/api/runs/:idThe run and, once finished, its full result with facts and receipts.
GET/api/ledger/:runId/:idOne receipt: the exact Qloo request and a hash of the answer.
POST/api/kitsPublish a finished report as a media kit. Returns the public and owner links.
curl -X POST https://somm-494617981995.us-central1.run.app/api/scout \
  -H 'content-type: application/json' \
  -d '{"property":{"kind":"podcast","name":"This Week in Startups",
       "entities":[{"name":"This Week in Startups","type":"podcast"},
                   {"name":"Jason Calacanis","type":"person"}]}}'

curl -N https://somm-494617981995.us-central1.run.app/api/runs/<runId>/events