for agentsMCP · JSON · Markdown

Built to be read by machines

Every Syftly answer is one object — a citeerbare summary, a provider table, dated sources and a confidence label — served three ways. Pick the one your agent speaks. Each returns the exact same answer; only the envelope differs.

POST/api/mcp

An MCP tool over Streamable HTTP (stateless JSON-RPC 2.0). One tool, find_best_tool: pass a natural-language question, get the ranked recommendation as structured output. Standard methods initialize and tools/list work too.

# set SYFTLY to your deployment, e.g. http://localhost:3000
curl -X POST "$SYFTLY/api/mcp" \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "find_best_tool",
      "arguments": { "query": "Best transcription API for Dutch" }
    }
  }'

# → result.content[0].text   = the citeerbare hap (verbatim)
#   result.structuredContent = the full Antwoord-artefact (matches outputSchema)

Honest limitation: pull-only today — no SSE stream or session id yet. Strict connector clients that require streaming aren't supported until that lands (cheap to add).

GET/api/answer?query=

The whole Antwoord-artefact as JSON. Query by the natural question or its slug; 404 if no answer is published yet.

curl "$SYFTLY/api/answer?query=best-transcription-api-for-dutch"

{
  "query": "Best transcription API for Dutch",
  "zekerheidslabel": "light estimate",
  "laatst_bijgewerkt": "2026-06-19",
  "recommendation": { "default": "ElevenLabs Scribe v2", "axes": { … } },
  "providers": [ { "naam": "ElevenLabs Scribe v2",
                   "prijs": { "waarde": …, "eenheid": "$/1000min" }, … } ],
  "bronnen": [ … ]
}
GET/api/answer?query=…&format=md

The same answer as Markdown (text/markdown), ready to drop straight into a context window.

curl "$SYFTLY/api/answer?query=best-transcription-api-for-dutch&format=md"

# Best transcription API for Dutch

**Confidence:** light estimate · **Last updated:** 2026-06-19

For Dutch speech-to-text, ElevenLabs Scribe v2 tops the leaderboard …

## Provider offerings

| Offering | Provider | Price | Strong | Weak | Source |
| --- | --- | --- | --- | --- | --- |
| ElevenLabs Scribe v2 | ElevenLabs | 0.4 $/1000min | … | … | Artificial Analysis (2026-06-10) |
Every answer carries a confidence label. Transcription today is a light estimate: aggregated from public benchmarks (with sources and dates), not first-hand Syftly measurement.