AGENT API

GMIIE Context API

A single endpoint that returns a structured, LLM-ready intelligence briefing — top articles, signal scores, entity rankings, and live tracker states. Feed it directly to Claude, GPT, or any MCP-compatible agent.

Endpoint

GET/api/contextNo authentication required

Query Parameters

ParamTypeDefaultDescription
daysinteger30Lookback window in days (1–90). Articles and signals within this period are included.
limitinteger10Maximum number of articles to return (1–50). Articles sorted by importance score descending.
typestringallFilter by article type. Options: all, brief, deep_dive, research_article, report, regulator_tracker, strategic_memo.

Usage Examples

cURL — last 7 days, top 5 articles

bash
curl "https://gmiie.xxxiii.io/api/context?days=7&limit=5"

Claude system prompt injection

javascript
const ctx = await fetch("https://gmiie.xxxiii.io/api/context?days=7&limit=10").then(r => r.json());

const systemPrompt = `You are a capital markets analyst.
Use the following live GMIIE intelligence data in your analysis:
${JSON.stringify(ctx, null, 2)}`;

MCP tool definition (tools array)

json
{
  "name": "gmiie_context",
  "description": "Fetch live capital market intelligence from GMIIE. Returns articles, signal scores, entities, and stablecoin tracker states.",
  "parameters": {
    "type": "object",
    "properties": {
      "days": { "type": "integer", "description": "Lookback in days (1-90)", "default": 30 },
      "limit": { "type": "integer", "description": "Max articles (1-50)", "default": 10 },
      "type": { "type": "string", "description": "Article type filter", "default": "all" }
    }
  }
}

Response Schema

typescript
{
  ok: boolean;
  generatedAt: string;        // ISO 8601
  period: { days: number; since: string };

  intelligence: {
    count: number;
    articles: Array<{
      url: string;             // Full URL on gmiie.xxxiii.io
      title: string;
      headline: string;
      dek: string | null;
      summary: string | null; // Executive summary
      type: ArticleType;
      importance: number;     // 0–10 editorial score
      publishedAt: string;
      region: string | null;
      assetClass: AssetClass | null;
      source: string | null;
      topics: string[];
      entities: { name: string; type: EntityType }[];
      signal: {
        overall: number;       // 0–100
        institutional: number;
        regulatory: number;
        readiness: number;
        urgency: number;
      } | null;
    }>;
  };

  signals: {
    sampleSize: number;
    dimensions: Array<{
      key: string;             // e.g. "institutional_adoption"
      label: string;
      score: number;           // 0–100 30-day average
    }>;
  };

  entities: {
    count: number;
    items: Array<{
      name: string;
      type: EntityType;
      country: string | null;
      region: string | null;
    }>;
  };

  tracker: {
    activeCount: number;
    states: Array<{
      name: string;            // e.g. "Florida"
      abbreviation: string;   // e.g. "FL"
      status: StateTrackerStatus;
      summary: string | null;
      nextStep: string | null;
      lastAction: string | null;
    }>;
  };
}

Live Preview

No data — click Run to fetch a live preview.

Related tools