Bouwen met Sugra API.

Eerste request binnen een minuut. Native MCP-server voor Anthropic Claude, OpenAI GPT, Google Gemini en xAI. OpenAI function calling, Anthropic tool use en een getypeerde OpenAPI 3.1 spec voor elke agent-stack die U draait.

API-sleutel ophalen API-referentie Terug naar API-hub
Quickstart

Eerste call binnen een minuut.

Registreer, pak Uw API-sleutel op de Settings-pagina en stuur Uw eerste request. Elk antwoord is out-of-the-box LLM-ready.

# GET US CPI - last 3 observations
curl -H "x-api-key: sugra_ao1_..." \
     "https://sugra.ai/api/fred/us/cpi?mode=last_n&n=3"
import httpx

r = httpx.get(
    "https://sugra.ai/api/fred/us/cpi",
    params={"mode": "last_n", "n": 3},
    headers={"x-api-key": "sugra_ao1_..."},
)
payload = r.json()
print(payload["data"], payload["meta"]["data_time"])
const res = await fetch(
  "https://sugra.ai/api/fred/us/cpi?mode=last_n&n=3",
  { headers: { "x-api-key": "sugra_ao1_..." } }
);
const { data, meta } = await res.json();
console.log(data, meta.data_time);
Elk antwoord:
{ "data": [ ... ], "meta": { "source", "data_time", "unit_type", "cached", "fallback_used" } }
Voor AI-agents

Geef een agent de spec. Dat is de integratie.

Wijs een AI-agent naar sugra.ai/openapi.json, geef hem Uw API-sleutel en hij weet alles wat Sugra kan doen. Elk endpoint, elke parameter, elk responsschema - beschreven in een getypeerde OpenAPI 3.1 spec met consistente Envelope-generics en semantische meta-velden. Geen custom integratie. Geen tool-schrijven. Geen documentatie-parsing.

Wanneer een gebruiker een vraag stelt die meerdere domeinen overspant - "wat is de CPI-trend, en hoe beïnvloedt het weer in de US-graangordel de graanprijzen?" - kiest een agent die de spec leest de juiste endpoints uit de 1476 beschikbare, roept ze parallel aan en stelt één gefundeerd antwoord samen uit primaire bronnen. Centralebankdata, weersobservaties, grondstofprijzen - alles in dezelfde LLM-ready envelope.

Geen surfen op het web. Geen doorpluizen van blogposts, forumdiscussies en verouderde gecachte pagina's. Geen ruisfiltering. Geen gehallucineerde getallen. Alleen de bron, de tijdstempel, de waarde - en een schoon pad van vraag naar antwoord.

Agent session
# Give an agent everything it needs to know:
export SUGRA_SPEC="https://sugra.ai/openapi.json"
export SUGRA_KEY="sugra_ao1_..."

# Ask a cross-domain question:
agent.ask("How is US inflation trending, and what is
           the weather doing to Midwest grain prices?")

# Agent picks endpoints automatically from 1476:
GET /api/fred/us/cpi                -> CPI series + data_time
GET /api/weather/forecast           -> Iowa, Illinois, Nebraska
GET /api/commodities/grains/corn    -> prices + source

# One grounded answer. Primary sources. Clean path
# from question to answer.
Verbind Uw agent, MCP-server live!

Native MCP-server voor Anthropic Claude, OpenAI GPT, Google Gemini, xAI en elke MCP-compatibele IDE. Installeer met pip install sugra-api-mcp of verbind met https://app.sugra.ai/mcp - dezelfde server, twee transports. Voor niet-MCP-agents: OpenAI function calling en Actions via OpenAPI 3.1.

De spec is productieverrijkt: getypeerde Envelope[T] generics op 1476 endpoints, Markdown-beschrijvingen, globale foutschema's, APIKeyHeader security, externalDocs links.