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" }
}
}| Tool | Arguments | Returns |
|---|---|---|
| fan_fingerprint | property_name, kind, entities[], market? | Taste tags, age and gender lean, where fans concentrate, momentum, and what else they love, with receipts. |
| prospect_sponsors | property_name, kind, entities[], categories?, exclusives? | Brands the fans over-index for in each category, scored and gated. |
| fit_score | property_name, kind, entities[], brand, category, competitors?, current_sponsors? | One brand against one property: score, verdict, reasons and evidence. |
| evaluate_offer | brand, category, competitors?, offer_text | Reads 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/scout | Start a sponsor report. Body: { property } or { description }. Returns { runId }. |
| POST | /api/diligence | Start an offer review. Body: { brand: { name, category, competitors }, offersText }. |
| GET | /api/runs/:id/events | Server-sent events: each step, each Qloo request, questions, and done. |
| GET | /api/runs/:id | The run and, once finished, its full result with facts and receipts. |
| GET | /api/ledger/:runId/:id | One receipt: the exact Qloo request and a hash of the answer. |
| POST | /api/kits | Publish 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