Sugra APIで構築する。

最初の呼び出しまで1分未満。

登録して、設定ページからAPIキーを取得し、最初のリクエストを送信してください。すべてのレスポンスは、そのままLLMで扱える形式で返されます。

# 米国CPIの直近3件の観測値を取得
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);

{ "data": [ ... ], "meta": { "source", "data_time", "unit_type", "cached", "fallback_used" } }

エージェントに仕様を渡す。それが連携のすべてです。

AIエージェントにsugra.ai/openapi.jsonを指定してAPIキーを渡すだけで、エージェントはSugraでできることをすべて把握します。すべてのエンドポイント、すべてのパラメーター、すべてのレスポンススキーマが、一貫したEnvelopeジェネリクスとセマンティックなmetaフィールドを備えた型付きOpenAPI 3.1仕様に記述されています。独自の連携開発は不要です。ツールを書く必要も、ドキュメントを解析する必要もありません。

ユーザーが「CPIはどう推移しているか、米国穀倉地帯の気象は穀物価格にどう影響しているか」といったドメイン横断の質問をすると、仕様を読み込んだエージェントは利用可能な1563個のエンドポイントから適切なものを選び、並列に呼び出し、一次情報に基づく1つの回答を組み立てます。中央銀行のデータ、気象観測、商品価格。そのすべてが同じLLM対応のエンベロープで返されます。

Webを巡回する必要はありません。ブログ記事、フォーラムのスレッド、古いキャッシュページを漁ることも、ノイズを取り除く作業も不要です。ハルシネーションによる数値もありません。あるのはデータソース、タイムスタンプ、値、そして質問から回答までの明確な経路だけです。

# エージェントに必要な情報をすべて渡す:
export SUGRA_SPEC="https://sugra.ai/openapi.json"
export SUGRA_KEY="sugra_ao1_..."

# ドメイン横断の質問をする:
agent.ask("米国のインフレはどう推移しているか、
           気象は中西部の穀物価格にどう影響しているか")

# エージェントが1563個のエンドポイントから自動で選択:
GET /api/fred/us/cpi                -> CPI時系列 + data_time
GET /api/weather/forecast           -> アイオワ、イリノイ、ネブラスカ
GET /api/commodities/grains/corn    -> 価格 + source

# 根拠のある1つの回答。一次情報。
# 質問から回答までの明確な経路。

Anthropic Claude、OpenAI GPT、Google Gemini、xAI、そしてMCP対応のあらゆるIDEで使えるネイティブMCPサーバー。pip install sugra-api-mcpでインストールするか、https://app.sugra.ai/mcpに接続してください。同じサーバーを2つのトランスポートで提供しています。MCP非対応のエージェントには、OpenAIのfunction callingとOpenAPI 3.1経由のActionsを利用できます。

この仕様は本番運用向けに拡充されています。1563個のエンドポイントに適用された型付きEnvelope[T]ジェネリクス、Markdownによる説明、グローバルなエラースキーマ、APIKeyHeaderセキュリティ、externalDocsリンクを備えています。

Continue to topic.

Six platform topics and the seven-direction product family. The current section is highlighted - pick where to go next.