MarginsX MarginsX
Developers · MCP, retrieval and REST

Filing data your model can cite.

MarginsX reads every SEC filing, exhibit and filed press release we hold, links companies through the people, holders, auditors, agents and subsidiaries named in those filings, and keeps the source of every figure and link. Your model, whichever you run, gets it three ways: an MCP server, a retrieval endpoint that returns cited passages inside a character budget, and a REST API over the same data. A free key gives your agent 100 units a month.

MCP endpoint
https://capital.sophiaxt.com/mcp
Retrieval
GET or POST /api/rag
Auth
Authorization: Bearer sxc_…
Model on our side
None. Every item cites its filing
For AI builders

Three ways in, one source chain.

We don't rank, summarise or write anything with a model on our side. Your model reads what we return, and every item carries the filing it came from, so an answer built on it can be checked line by line.

MCP

Point any MCP client at the endpoint with Authorization: Bearer sxc_... over Streamable HTTP. The lattice adds five tools to the data, reader, search, map, ownership and topic tools already there: rag_search, lattice_neighbors, lattice_path, explain_source and lattice_stats.

Each tool is the same function as its REST route, so a tool call and an HTTP call return the same JSON.

Retrieval

GET /api/rag?q=... or POST /api/rag with a JSON body. It returns ranked passages from filings, the named companies' key figures and connections, and a citation for every item, all inside max_chars.

Signed out, you can try it at a few calls a minute, with at most five passages and 4,000 characters.

REST

/api/lattice/neighbors, /api/lattice/path, /api/lattice/explain and /api/lattice/stats, plus the existing /api/data, /api/map and /api/search routes.

A key acts as its account's plan. Every call counts against the monthly allowance and the per-minute rate in Pricing.

Retrieval: /api/rag and rag_search

Cited passages, inside a character budget.

Ask in plain words. Tickers in the question (IREN, $NROM) scope the passages to that company and pull its figures and connections. You can also pass entities (tickers or CIKs) with or without a question, and filters for forms, dates and investor topics.

How it ranks: BM25 over every indexed passage, using the question's rarest content words, fused by reciprocal rank fusion with k = 60 (Cormack, Clarke and Buettcher, 2009) with a second list: the same passages, keeping only those from documents about an investor topic the question names (going concern, uranium, at-the-market offerings, bitcoin mining). The second list can reorder BM25's candidates but never add one. That is the default because it measured best on our held-out set (below). An older topics channel, which also scores the passage that shows the topic, is available with "channels": ["bm25", "topics"] and measured lower. Topics still work as a filter (filters.topics), and every answer lists the topics its question names. The answer's method field says which channels ran. A channel for neural vectors has a slot and is null today.

The budget: max_chars (500 to 40,000, default 8,000) covers passages, figures and connections together. When companies are named, a quarter of it is kept for their figures and connections. limit is 1 to 20 passages.

POST /api/raga passage, then a figure
{ "question": "What did IREN say about its AI cloud contracts?", "limit": 5, "max_chars": 6000 }

{ "rank": 2,
  "text": "Our AI Cloud Services revenue for the three months ended September 30, 2026 and 2025, was $135 million and $7 million, respectively. The increase was driven by an increase in AI Cloud Services customers and contracts, as a result of continued capacity expansion, and by revenue contributed by Mirantis following its acquisition on August 3, 2026.",
  "citation": { "company": "IREN Ltd", "ticker": "IREN", "form": "10-Q", "filed": "2026-11-05",
    "accession": "0001878848-26-000066",
    "url": "https://www.sec.gov/Archives/edgar/data/1878848/000187884826000066/iren-20260930.htm",
    "lattice_id": "passage:sec:0001878848-26-000066:0001878848#1108" },
  "scores": { "rrf": 0.031746, "bm25_rank": 3 } }

{ "company": "IREN Limited", "fact": "Revenue over the last four quarters (TTM)",
  "value": 694712000, "unit": "USD", "as_of": "2026-09-30",
  "citation": { "name": "SEC XBRL company facts", "form": "10-Q", "filed": "2026-11-05" } }

Shortened from a real answer: the full citation also carries the document id, passage number, anchor and a link that opens the passage in the MarginsX reader.

The lattice: nodes, edges and their sources

Every link names the filing it came from.

Every entity is a node with a readable id: company:<CIK>, listing:<symbol>, people, funds and firms, filing:<accession>, documents, passages, topics, facts, articles, reports and public anchors. Wherever a company id is asked for, a ticker or CIK works too.

Every relationship is a typed edge read from the table that owns it, with its source: ownership (13F, 10% owners, Schedule 13D, Form D fund managers), roles, service (auditor and engagement partner from PCAOB Form AP, placement and filing agents), structure (Exhibit 21 subsidiaries, listings, share classes), deals, money (related-party amounts, top customers, named customers and suppliers), topics with the evidence sentence, filing sequence, figures and public anchors.

"Similar" is the one edge we compute: two companies are linked when their vectors of named numbers (topic weights, sector and industry codes, size and a few ratios) are close enough, against a floor measured from the data. explain_source on a similar edge names the features the two share.

RESTa ticker or CIK works wherever a company id is asked for
GET /api/lattice/neighbors?id=IREN&kinds=role,service,similar&limit=10
GET /api/lattice/path?a=IREN&b=CLSK&max_hops=3
GET /api/lattice/explain?id=fact:fundamentals_q:0001878848:ttm_revenue:2026-09-30

explain returns the chain from an item to its source: for a figure, the value, the table row and column it was read from, the filing and the company; for a Data Desk sentence, each fact it used and that fact's filing. path walks up to four hops and won't walk through a hub linked to more than 400 companies, because a Big Four auditor or an index fund joins thousands and says nothing.

Measured retrieval quality

Measured, with the corpus it was measured on.

We measure retrieval on fixed question sets over real filings in our index, which held 2,417 documents and 288,711 passages from 1,610 companies at the time. Passages are drawn by a seeded, stratified sample, and writers who never saw the ranking code write one question per passage with the exact answer span marked. A returned passage counts when it contains the answer span. The development set has 64 questions. The held-out set has 152, drawn with a different seed from documents the development set never touches, and we wrote down the comparisons and the rule for changing the default before any held-out question existed. Brackets are 95% bootstrap intervals over questions.

Held-out, 152 questionsP@1Hit@5MRR@10
BM25 + topic-document reorder (the default)0.480 [0.401, 0.559]0.658 [0.579, 0.730]0.561 [0.488, 0.632]
BM25 alone0.461 [0.382, 0.539]0.645 [0.566, 0.717]0.542 [0.470, 0.614]
BM25 + the older topics channel0.382 [0.303, 0.461]0.592 [0.513, 0.671]0.469 [0.399, 0.539]

P@1 is the answer passage ranked first, Hit@5 the answer passage anywhere in the top five, MRR@10 the mean of one over the answer's rank, counted as zero outside the top ten. The default changed on the registered rule: the reorder's MRR@10 gain over BM25 alone was +0.018 [0.003, 0.038], with P@1 +0.020 [0.000, 0.046]. The gain is small and comes from questions that name no company. On the development set the reorder pointed slightly the other way, and pooled over all 216 questions after the fact the difference is +0.004 [-0.014, 0.022]. The older topics channel lowered P@1 on both sets, which is why it is opt-in. On the development set BM25 alone scored P@1 0.531 [0.406, 0.656] and Hit@5 0.797 [0.703, 0.891]. These numbers belong to that index. The benchmark's result records the index's size, so numbers from a larger index are never mixed with these.

Limits, stated plainly

What it doesn't do.

Coverage follows stored text

Passages are searchable only for filings whose text we have stored, and /api/lattice/stats and every /api/rag answer report the index's size and date range. Today most of it is 8-K and 6-K releases and recent 10-Qs, so a question about an older annual report can come back empty.

Retrieval is lexical

It finds passages that use the question's words or name its topic. It doesn't resolve synonyms beyond our topic vocabulary, doesn't read tables as numbers, and doesn't answer the question; your model does that from the passages.

Topics need read filings

Companies without stored text are placed on the map and linked as similar by their sector, industry code, size and financials alone. The stats say how many have topics.

The 3D layout is for people

The position you see in the explorer is never used to rank.

Private data stays private

Members' private and link-shared anchors and private notebooks are never part of the lattice or any answer. 13F holder edges and institutional ownership need a plan with Money Flow data.

Public, free sources

SEC EDGAR filings and data sets, PCAOB Form AP and exchange listing directories. Prices some tools return come from free public feeds and are not licensed for resale.

What the tools return

Four groups, one shape.

Every tool returns one JSON text block. Lists come back trimmed so a reply fits in a model's context, and most replies include a sources or source_url field pointing at the public record the row came from. The examples below are real replies from the server, cut to one row.

US private markets

Built from SEC Form D (Reg D offerings) and Form ADV adviser data. The screen_index, market_trends, benchmark_index and daily_market_report tools read our own index of every Form D since 2008, so they are complete rather than sampled. The others query SEC full-text search live.

  • search_deals private raises by keyword, date, state, industry and size
  • get_deal one Form D in full: terms, exemptions, related persons, placement agents and fees
  • search_funds VC, PE, hedge and other pooled funds that filed raises
  • search_firms EDGAR filers and registered advisers by name
  • get_firm profile by CIK (raise history, filings) or CRD (ADV status, disclosures)
  • search_people executives, directors and promoters named on Form D, with their companies
  • market_benchmark raise-size distribution for a slice, from a sample of matching filings
  • screen_index screen every Form D since 2008 by industry, fund type, state, date and size
  • market_trends quarterly count and capital of new raises for any slice
  • benchmark_index full-population percentiles, investor counts, broker usage, largest deals
  • daily_market_report one filing day against the 30-day average: largest raises, new funds, hot sectors
screen_indexindustry "Biotechnology", states ["MA"], sort "size"
{
  "total": 1755,
  "deals": [
    {
      "accession": "0001567619-23-000019",
      "cik": "0001885522",
      "issuer": "Neumora Therapeutics, Inc.",
      "filed": "2023-01-03",
      "form": "D",
      "city": "Watertown",
      "state": "MA",
      "industry": "Biotechnology",
      "fund_type": null,
      "offering_amount": 474356988,
      "offering_indefinite": 0,
      "amount_sold": 474356988,
      "investors": 124,
      "first_sale": "2020-09-08",
      "securities": "Equity, Security To Be Acquired",
      "entity_type": "Corporation",
      "revenue_range": "Decline to Disclose"
    }
  ]
}

Form D amounts are self-reported by the issuer, and many funds report the offering size as indefinite.

Raising: audit, investors, PDFs

Deterministic scoring and investor matching against the same Form D and Form ADV index. These are the tools behind the app's company audit and Investor Finder, and they need a paid plan.

  • score_companyFounder+ investability score 0 to 100 with components, reasons and fixes
  • match_investorsFounder+ ranked VC/PE advisers from Form ADV, funds that raised recently with their GPs, placement agents in the sector, comparable raises
  • make_pdfFounder+ a pitch deck, the daily market report or an investability report as a PDF; returns a link valid for 24 hours. Pitch decks need Founder or Firm.
score_company"Other Technology", MI, seed, $2M raise
{
  "score": 62,
  "grade": "C",
  "parts": {
    "market_heat": 64,
    "raise_fit": 90,
    "capital_availability": 72,
    "traction": 50,
    "readiness": 20
  },
  "market": {
    "sector_raises_12m": 3822,
    "sector_capital_12m": 93088272148,
    "yoy_growth_pct": 9,
    "median_raise": 2018795,
    "p25": 337500,
    "p75": 8000005,
    "local_funds": 121
  },
  "reasons": [
    "Other Technology: 3,822 raises in the last 12 months, up 9% on the year before.",
    "A $2M raise against a sector median of $2M (middle half $338K to $8M).",
    "121 VC/PE funds based in MI filed raises in the last two years (30,930 nationally)."
  ],
  "fixes": [
    "Missing a financial model.",
    "Missing a Delaware C-corp (most VCs require it)."
  ]
}

Cut from the full reply, which also returns the component weights, p90 and the remaining fixes.

US public markets, filings and news

Daily closes for listed US stocks, SEC Form 4 insider purchases, the EDGAR latest-filings feed, press releases from public wire feeds and from 8-K and 6-K exhibits, event dates pulled from those releases, SEC fails-to-deliver data, and Polymarket and Kalshi odds.

  • market_trends_public sector rotation, leaders and laggards, 52-week highs and lows, unusual volume, breadth by size tier
  • insider_buys open-market insider purchases (Form 4, code P) with a link to each filing
  • live_filings the newest EDGAR filings as they post, filterable by form type
  • news wire press releases and SEC-filed press releases; law-firm solicitations dropped by default
  • press_release_text full text of one SEC-filed press release
  • earnings_calendar earnings calls, investor days and AGMs, each with the quoted sentence and source link
  • fails_to_deliver 12 months of SEC fails-to-deliver balances for a symbol
  • prediction_marketsFounder+ daily snapshots of Polymarket and Kalshi odds on rates, inflation, equities and more
insider_buysdays 14
{
  "rows": [
    {
      "accession": "0000921895-26-002784",
      "filed": "2026-10-13",
      "trade_date": "2026-10-13",
      "ticker": "GME",
      "issuer": "GameStop Corp.",
      "insider": "Cohen Ryan",
      "title": "President, CEO and Chairman, Director",
      "shares": 844130,
      "avg_price": 26.98011858363048,
      "value": 22774727.5,
      "shares_after": 42492652,
      "url": "https://www.sec.gov/Archives/edgar/data/1326380/000092189526002784/0000921895-26-002784-index.htm",
      "market_cap": 13732516948
    }
  ],
  "scanned": { "n": 570, "first": "2026-10-13", "last": "2026-10-14" },
  "source": {
    "name": "SEC EDGAR Form 4, transaction code P (open-market purchase)",
    "url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcurrent&type=4",
    "fetched_at": "2026-10-14T19:25:53.238Z"
  }
}

Canada

TSX and TSX Venture issuers from the TMX issuer list, CIRO halt and resumption notices, the Ontario Securities Commission's exempt-distribution summary, the Corporations Canada federal registry, and the Government of Canada's open grants and contracts datasets. Disclosure documents come from SEC EDGAR filings by Canadian issuers and from company investor-relations sites.

  • canada_search find a listed issuer by name or ticker
  • canada_company profile: listing facts, market cap, momentum, peers, Form D raises, documents, halts, events
  • canada_screen screen listed stocks by exchange, sector, province, size and returns
  • canada_markets counts and cap by tier, sector and exchange, top movers, FX rate
  • canada_filings newest disclosure documents, grouped by type (annual report, MD&A, prospectus and others)
  • canada_halts CIRO halts and resumptions on TSX, TSXV, CSE and Cboe Canada
  • canada_private_placements Form 45-106F1 distributions with Ontario purchasers
  • canada_federal_corporation federal registry records by name, number or business number
  • canada_government_funding federal grants and contributions, and contracts over C$10,000
canada_private_placementsq "lithium"
{
  "total": 317,
  "rows": [
    {
      "submission_id": "06498237-1",
      "report_type": "new",
      "issuer": "Vinland Lithium Inc.",
      "is_fund": 0,
      "naics_label": "All other non-metallic mineral mining and quarrying",
      "start_date": "2026-09-24",
      "filed_date": "2026-09-28",
      "amount_cad": 88920,
      "purchasers": 7,
      "ontario_purchasers": 7,
      "exemptions": [
        "Accredited investor C$65880",
        "Family, friends and business associates C$23040"
      ],
      "ticker": "VLD",
      "exchange": "TSXV",
      "source_url": "https://www.osc.ca/sites/default/files/2026-10/Report-of-Exempt-Distribution-20160601-to-20261001.xlsx"
    }
  ],
  "notes": [
    "Amounts and purchaser counts are for Ontario purchasers only: …"
  ],
  "sources": [
    {
      "label": "Ontario Securities Commission, Exempt Distributions Summary (Form 45-106F1 reports with Ontario purchasers)",
      "licence": "Open Government Licence - Ontario"
    }
  ]
}

The full reply carries four notes on what the OSC summary covers and leaves out. Amounts are Ontario purchasers only.

Get a key

Four steps, about two minutes.

1

Create an account

Sign up at capital.sophiaxt.com. The Free plan needs no card.

2

Turn on two-factor

API keys need an authenticator app on the account. Set it up under Account, Two-factor sign-in.

3

Create a key

Account, API keys for agents. Name it after the agent that will use it. The key starts with sxc_.

4

Store it once

The full key is shown one time. We keep only a hash of it, so a lost key gets revoked and replaced.

An account can hold five active keys, each revocable on its own. A key acts with its account's plan and nothing more. Send it in the Authorization header only; keys in a query string are refused, because URLs end up in logs.

Connect

Point your client at one URL.

Replace sxc_YOUR_KEY with your key. Keep the key out of files you commit.

One command adds the server for your user account.

claude mcp add --transport http --scope user marginsx https://capital.sophiaxt.com/mcp \
  --header "Authorization: Bearer sxc_YOUR_KEY"

Run /mcp inside Claude Code to see the tools.

Claude Desktop starts local servers from claude_desktop_config.json, so a small bridge (mcp-remote, run by npx) forwards to the remote endpoint with your key. Needs Node.js 18 or newer.

{
  "mcpServers": {
    "marginsx": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://capital.sophiaxt.com/mcp",
        "--header", "Authorization:${SOPHIA_AUTH}"
      ],
      "env": { "SOPHIA_AUTH": "Bearer sxc_YOUR_KEY" }
    }
  }
}

The header value goes through an environment variable because some platforms split arguments on the space in "Bearer sxc_…". Restart Claude Desktop after saving.

Add this to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.

{
  "mcpServers": {
    "marginsx": {
      "url": "https://capital.sophiaxt.com/mcp",
      "headers": { "Authorization": "Bearer sxc_YOUR_KEY" }
    }
  }
}

The tools appear under Settings, MCP once Cursor reloads the file.

Any client that speaks Streamable HTTP works. With the official TypeScript SDK:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("https://capital.sophiaxt.com/mcp"),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.SOPHIA_CAPITAL_KEY}` } } },
);
const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(transport);

const r = await client.callTool({
  name: "screen_index",
  arguments: { industry: "Biotechnology", states: ["MA"], sort: "size", limit: 5 },
});
console.log(JSON.parse(r.content[0].text));

The server is stateless, so there is no session to open: each POST stands alone. Send both media types in Accept; replies come back as plain JSON.

# List the tools
curl -s https://capital.sophiaxt.com/mcp \
  -H "Authorization: Bearer $SOPHIA_CAPITAL_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Call one
curl -s https://capital.sophiaxt.com/mcp \
  -H "Authorization: Bearer $SOPHIA_CAPITAL_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"canada_halts","arguments":{"view":"recent","limit":5}}}'

GET and DELETE return 405, since there is no stream or session to hold open. Send one call per request; JSON-RPC batches are not part of the current MCP spec.

Pricing

Same plans as the app: a monthly allowance, then per-call pricing.

An API key uses the plan its account is on. A call costs one unit; calls that do more work can cost more, and /api/plans/map lists them. Allowances reset on the 1st (UTC) and are shared by every key on the account. Past the allowance, paid plans keep working at a price per 1,000 units, up to three times the allowance; Free stops until the 1st. Calls that fail on our side are never billed.

Free

$0
100units a month · 10 a minute per key
  • Search, filings, news, markets and Canada; full-text search to the first 50 hits
  • The Economap, ownership detail, Form 144, government money, private funds, signal history, audit, PDFs
Create account

Founder

$49/mo
5,000units a month · 30 a minute, then $10 per 1,000
  • Every tool except stock tracking
  • The Economap, full ownership tables, Form 144, government money and private funds
  • score_company and match_investors
  • make_pdf, including pitch decks
  • prediction_markets
Start with Founder

Investor

$199/mo
25,000units a month · 60 a minute, then $8 per 1,000
  • Every tool
  • 13F holders, money flow and signal history
  • make_pdf for reports
  • Pitch decks
Start with Investor

Firm

$899/mo
100,000units a month · 120 a minute, then $6 per 1,000
  • Every tool, pitch decks included
Start with Firm
ToolNeedsFreeFounderInvestorFirm
score_companyCompany auditnoyesyesyes
match_investorsInvestor Findernoyesyesyes
prediction_marketsPrediction-market boardnoyesyesyes
make_pdf (reports)PDF reportsnoyesyesyes
make_pdf (pitch_deck)Pitch deck buildernoyesnoyes
economap_*The Economapnoyesyesyes
government_money, and query_dataset on gov_awards, gov_contracts_ca and private_fundsGovernment money and private fundsnoyesyesyes
keyword_search, and search_all with type newsFull-text search depthfirst 50 hitsallallall
company_ownershipOwnership detail25 rows, no Form 144every row and Form 144plus 13F holdersplus 13F holders
signal_history, signal_types and signal_detail historySignal historynoyesyesyes

When a call is over the allowance, over the per-minute rate, or needs a higher plan, the tool returns an ordinary error result whose text says which limit applied and where to upgrade, so your agent can read it and tell you. A refused call does not count toward the allowance, and a call that fails on our side is never billed. Past the allowance a paid plan keeps working at its price per 1,000 units, up to three times the allowance; Free is refused until the 1st. Every plan's app and API features side by side are on the pricing page.

Where the data comes from

Public records, with the link kept.

United States

  • SEC EDGAR: Form D, Form 4, the latest-filings feed, 8-K and 6-K press-release exhibits, full-text search
  • SEC and state adviser registrations (Form ADV)
  • SEC fails-to-deliver files
  • Public press-release wire feeds, including PR Newswire and ACCESS Newswire
  • Daily closes for listed US stocks
  • Polymarket and Kalshi public market data

Canada

  • TMX issuer list (TSX and TSX Venture)
  • CIRO trading halt and resumption notices
  • Ontario Securities Commission exempt-distribution summary (Open Government Licence - Ontario)
  • Corporations Canada federal corporation data
  • Open Government proactive disclosure of grants, contributions and contracts
  • SEC EDGAR filings by Canadian issuers, and documents posted on company investor-relations sites

Collectors run on our server and keep a daily history, so tools that read the local tables answer from what we have captured, not from a live call to the source. Each reply says where its rows came from. Nothing here is investment advice.

FAQ

Questions developers ask.

Does this work as a custom connector on claude.ai?

Not yet. claude.ai custom connectors sign in with OAuth, and this endpoint uses API keys. Claude Code, Claude Desktop (through mcp-remote), Cursor and any client that can send an Authorization header work today.

Can I run the server locally instead?

The tools read a database that lives on our server and is filled by collectors that run every day. The hosted endpoint is the supported way to use them.

What happens to PDFs made by make_pdf?

The tool returns a link with a random name. The file is served for 24 hours and then deleted. Run the tool again for a fresh copy.

How do I see my usage?

Account, API keys shows this month's calls and units, the allowance, units past it and what they cost so far, calls by tool and by day, and refused calls. GET /api/plans/usage and the MCP tool my_api_usage return the same.

For billing, GET /api/billing/status returns the plan you pay for, the renewal or end date, any failed payment and its grace date, and this month's units and overage, and GET /api/billing/invoices lists your last 12 invoices with links to Stripe. The read-only MCP tool my_billing returns both. Neither call uses units. Plan changes and cancelling happen in the app.

How fresh is the data?

It depends on the source. Insider buys, halts, news and the live filings feed are collected through the day; the Form D index, adviser data and the Canadian registries update on their publishers' schedules. Replies carry fetch times or source dates where the source gives one.

Is a leaked key a problem?

Revoke it under Account, API keys and it stops working on the next call. A key can never act as an admin, only as its account's plan, and the per-minute rate limits what anyone can pull with it.