Developers

Tamarly in Claude, ChatGPT and your own code

Ask your AI assistant about any private company, fund or country and get answers from Tamarly data, with the filing behind each figure. Or call the same data from your code with a personal key. Read only, from public records, no market prices. Your plan decides which data you get, as on the site.

Connect the MCP server

The Tamarly MCP server lives at https://app.tamarly.ai/api/mcp. It speaks the Model Context Protocol over HTTP and signs you in with your Tamarly account in one click (OAuth 2.1 with PKCE).

Claude

In Claude, open Settings, then Connectors, and add a custom connector with the address above. Claude opens a Tamarly page where you sign in and choose Allow. Then ask, for example: "Which startups in California filed a first Form D this month for under $5 million?"

Claude Code

claude mcp add --transport http tamarly https://app.tamarly.ai/api/mcp

Run /mcp in Claude Code and choose Authenticate to sign in.

ChatGPT and other apps

Where your plan allows custom connectors, add a connector with the same address and sign in when asked. Apps that cannot sign in can send a personal key as a bearer token:

{
  "mcpServers": {
    "tamarly": {
      "type": "http",
      "url": "https://app.tamarly.ai/api/mcp",
      "headers": { "Authorization": "Bearer tmk_your_key" }
    }
  }
}

Create and revoke keys on My Account, API keys. Apps you connect with one click appear there as "Connector" and are disconnected by revoking them.

Tools

Tool	Plan	What it returns
`search`	Every plan	Find companies, funds, private fund managers and countries by name or ticker. Returns the type, the id (company slug, fund id, manager id or ISO3 country code) and a short detail for each match, up to 5 per type.
`get_company`	Level 2, Level 3, Trial	A company's profile (ticker, country, CIK, LEI, industry, revenue and employees where filed), its last 10 SEC Form D notices of private raises and the merger filings that name it, each with a source link.
`get_company_financials`	Level 2, Level 3, Trial	Reported financial figures (XBRL facts from SEC 10-K and 10-Q filings, or ESEF annual reports), each with fiscal year, form, filing date and accession number.
`list_private_raises`	Level 3, Trial	The venture radar: new SEC Form D notices from operating companies (funds and real estate left out), newest first, with amount sold, industry, state, filing link and whether it is the company's first raise on file. Form D does not name investors.
`list_deals`	Level 2, Level 3, Trial	Mergers and acquisitions found in SEC filings, newest first: target, acquirer, seller, status, first and last filing dates, filing link and grade.
`get_fund_holdings`	Level 2, Level 3, Trial	A fund's latest reported holdings from SEC Form N-PORT, top 50 with weights and values.
`get_fund_manager`	Level 2, Level 3, Trial	A private fund manager from SEC Form ADV or ESMA registers: headquarters, strategies, private fund assets, description and portfolio companies, with sources.
`get_country_risk`	Level 2, Level 3, Trial	The Tamarly Risk Atlas score for a country by week: the composite and 7 pillars, 0 least risky to 100 most.
`get_macro_series`	Every plan	An economic data series from FRED as stored by Tamarly, newest first, e.g. DGS10 (10-year Treasury yield), CPIAUCSL or UNRATE.

Every tool is read only. Answers include the source link of each figure, so the assistant can cite the filing.

Call the Platform API

Send a personal key in the Authorization: Bearer or X-Api-Key header. Every answer has the same shape: { api, data, sources: [{ source, url, as_of, licence }], disclaimer }. Routes with tables also answer ?format=csv.

curl https://app.tamarly.ai/api/v1/raises?max_usd=5000000&days=7 \
  -H "Authorization: Bearer tmk_your_key"

Route	Plan	What it returns
`GET /api/v1/search?q=`	Every plan	Companies, funds, fund managers and countries matching a name or ticker
`GET /api/v1/companies/{slug}`	Level 2, Level 3, Trial	Company profile, last 10 Form D notices, merger filings that name it
`GET /api/v1/companies/{slug}/financials?metric=&years=`	Level 2, Level 3, Trial	Reported figures from SEC and ESEF filings, with form, filing date and link
`GET /api/v1/companies/{slug}/quarters`	Level 2, Level 3, Trial	The last 12 quarter ends of filed lines
`GET /api/v1/companies/{slug}/guidance`	Level 3, Trial	Guidance tracker: ranges, revisions and filed results
`GET /api/v1/companies/{slug}/kpis`	Level 3, Trial	Company KPIs from results releases, with definitions and sources
`GET /api/v1/raises?max_usd=&days=&state=&industry=`	Level 3, Trial	New Form D raises from operating companies, $15 million or less by default
`GET /api/v1/deals?days=&company=`	Level 2, Level 3, Trial	Deals from SEC merger filings, newest first
`GET /api/v1/funds/{id}/holdings`	Level 2, Level 3, Trial	Latest N-PORT holdings, top 50
`GET /api/v1/managers/{id}`	Level 2, Level 3, Trial	A private fund manager from Form ADV or ESMA, with portfolio companies
`GET /api/v1/countries/{iso3}/risk?weeks=`	Level 2, Level 3, Trial	Risk Atlas composite and 7 pillars by week
`GET /api/v1/macro/{series}?from=`	Every plan	An economic series from FRED

Limits and rules

1,200 calls an hour per account, across the API and the MCP server.
5 personal keys and 10 connected apps per account. A key is shown once; only its hash is stored.
No share prices, by licence. Research data from public sources, not investment advice.
Errors come back in plain words: 401 for a missing or revoked key, 403 when the data is not in your plan, 429 when the hourly limit is reached.

Data comes from SEC EDGAR (Form D, 10-K, 10-Q, 13F, N-PORT, Form ADV, merger filings), ESEF annual reports, GLEIF, UK Companies House, FRED and the Tamarly Risk Atlas. See how to read a Form D and how to fact-check AI answers about companies.

Start free for 7 days and get a key

Questions: contact@tamarly.ai. Terms.