API Documentation

Free Endpoints — No Authentication Required

Returns the company primer — business overview, financial snapshot, and recent catalysts. No authentication required. Use to orient an agent to a company before deciding whether to purchase deeper analysis.

curl https://app.marginofinsight.com/api/v1/research/V/primer

Returns all covered tickers with freshness metadata. Use before making a paid call to verify coverage exists.

curl https://app.marginofinsight.com/api/v1/coverage

{
  "count": 19,
  "tickers": [
    {
      "ticker":        "AXON",
      "company":       "Axon Enterprise",
      "exchange":      "NASDAQ",
      "sector":        "Technology",
      "covered":       true,
      "last_updated":  "2026-04-10T12:37:58Z",
      "freshness_days": 30
    }
  ],
  "api_version": "v1"
}

Returns coverage metadata for a single ticker — availability, freshness, and which tiers are accessible.

curl https://app.marginofinsight.com/api/v1/coverage/V

{
  "ticker":          "V",
  "company":         "Visa",
  "exchange":        "NYSE",
  "sector":          "Financials",
  "covered":         true,
  "last_updated":    "2026-04-05T08:06:50Z",
  "coverage_as_of":  "2026-Q2",
  "freshness_days":  35,
  "tiers_available": ["free", "fundamental", "full"],
  "api_version":     "v1"
}

Request coverage for a ticker not yet in the universe. Free, no authentication required. Fulfilled in 24–48 hours. Provide an email to be notified when research is ready.

curl -X POST https://app.marginofinsight.com/api/v1/coverage/request \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AAPL", "email": "you@example.com"}'

{
  "status":                 "queued",
  "ticker":                 "AAPL",
  "request_id":             "cmp034k620001nbbp...",
  "estimated_ready_hours":  24,
  "notification":           "We'll email you@example.com when research is ready."
}

Paid Endpoints — SPT Bearer Token Required

Returns 12-step fundamental analysis (incl. returns on capital / ROIC). Sufficient for screening agents filtering 20 stocks down to 3–4. Includes all free tier fields plus earnings transcripts, competitive positioning, risk register, balance sheet, and industry context.

curl https://app.marginofinsight.com/api/v1/research/V/fundamental \
  -H "Authorization: Bearer spt_xxxxxxxxxxxxxxxx"

Returns the full 21-step investment memo (incl. returns on capital and institutional/insider activity). Equivalent to a sell-side initiation note. An LLM generating this research independently costs $7–9 in API calls and 10–20 minutes.

curl https://app.marginofinsight.com/api/v1/research/V/memo \
  -H "Authorization: Bearer spt_xxxxxxxxxxxxxxxx"

Error Responses

{
  "error":       "not_covered",
  "ticker":      "AAPL",
  "request_url": "POST /api/v1/coverage/request"
}

{
  "error":   "spt_invalid",
  "message": "Token revoked or expired. Re-issue via Stripe Link."
}

{
  "error":         "payment_declined",
  "decline_code":  "card_declined",
  "message":       "Stripe declined the payment. See decline_code for reason."
}

{
  "error":   "rate_limited",
  "message": "Too many requests. Retry-After header indicates seconds to wait."
}

Billing & SPT Lifecycle

There is no marginofinsight account in the agent path. Billing happens entirely on the Stripe side via your Shared Payment Token. The token represents your operator's authorization to spend from their Stripe Link wallet — marginofinsight introspects and charges the token on each paid call. Nothing is stored on our side beyond the request log.

Looking for a managed dashboard with usage history and a card on file? That product lives at app.marginofinsight.com and is built for human fund managers — see the homepage. The agent API path documented here uses SPT and does not require an account.

MCP Server LIVE

Model Context Protocol server using Streamable HTTP transport. Stateless, JSON responses. Six tools wired to the same research backend as the REST API.

https://app.marginofinsight.com/api/mcp

{
  "mcpServers": {
    "margin-of-insight": {
      "transport": "streamable-http",
      "url":       "https://app.marginofinsight.com/api/mcp",
      "headers": {
        "Authorization": "Bearer spt_xxxxxxxxxxxx"
      }
    }
  }
}

{
  "mcpServers": {
    "margin-of-insight": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.marginofinsight.com/api/mcp",
               "--header", "Authorization:Bearer spt_xxxxxxxxxxxx"]
    }
  }
}

Claude Desktop does not yet support native Streamable HTTP, so bridge via the community mcp-remote package. Drop your SPT into the Authorization header — paid tools use the same token as the REST API.