API · MCP · OpenAPI

Developers

A JSON API and a remote MCP server so AI agents and developers can query the directory: company snapshots with source-linked facts, ETF exposure, the AI & Robots Mention Index and screening. Every response carries a citation and a short disclaimer.

OpenAPI 3.1 spec Free sample MCP server Pricing llms-full.txt MCP server card

Companies

ETFs tracked

SEC filings counted

400

41 companies

Data refreshed

2026-11-02

Weekly

Paid calls

Coming soon

x402, about $0.01 USDC per call

Quick start

No sign-up. Start with the free sample; it returns the same shapes as the paid endpoints.

Free sample · no key

curl https://airoboticsdirectory.com/api/v1/sample/companies/nvidia
curl "https://airoboticsdirectory.com/api/v1/sample/mentions?sort=change&group=ai"
curl "https://airoboticsdirectory.com/api/v1/sample/places?near=39.74,-104.99"
curl https://airoboticsdirectory.com/api/v1/companies   # all slugs (free)

const res = await fetch("https://airoboticsdirectory.com/api/v1/sample/companies/nvidia");
const { data, meta, disclaimer } = await res.json();

console.log(data.name);      // "NVIDIA"
console.log(meta.citation);  // cite the company page
console.log(disclaimer);     // keep it with the data

import requests

r = requests.get("https://airoboticsdirectory.com/api/v1/sample/companies/nvidia", timeout=10)
body = r.json()

print(body["data"]["name"])      # "NVIDIA"
print(body["meta"]["citation"])  # cite the company page
print(body["disclaimer"])        # keep it with the data

# Add to your MCP client config (Claude, Cursor, VS Code…)
{
  "mcpServers": {
    "ai-robotics-directory": {
      "url": "https://airoboticsdirectory.com/mcp"
    }
  }
}

# Or call it directly:
curl -X POST https://airoboticsdirectory.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Paid endpoints

curl -i https://airoboticsdirectory.com/api/v1/companies/nvidia
# 503 + "paid access coming soon" while payments are off
# 402 Payment Required (x402) once they are on

curl -H "X-API-Key: YOUR_KEY" https://airoboticsdirectory.com/api/v1/companies/nvidia

Endpoints

Base URL https://airoboticsdirectory.com. All responses are JSON: { data, meta, disclaimer }. Slugs come from /api/v1/companies.

Endpoint	Returns	Access
GET`/api/v1`	API index: endpoints, pricing and payment status.	Free
GET`/api/v1/openapi.json`	OpenAPI 3.1 specification.	Free
GET`/api/v1/companies`	All companies with slug, name, category, ticker and listing status.	Free
GET`/api/v1/sample`	Free samples with the same response shapes as the paid endpoints, limited to nvidia, tesla, intuitive-surgical, BOTZ, the places waymo-robotaxi-denver, computer-history-museum-ai-robotics-gallery, automate, or 5 rows.	Free
GET`/api/v1/companies/{slug}`	Company snapshot: description, facts with source URLs and as-of dates, ETF membership, recent SEC filings and the latest Mention Index stats.	Paid
GET`/api/v1/mentions/{slug}`	Full Mention Index history: every counted SEC filing with word count, raw counts, rate per 10,000 words and change vs the prior comparable filing.	Paid
GET`/api/v1/mentions?sort=rate\|change&group=ai\|robots\|physical&limit=`	Mention Index leaderboard, ranked by latest rate or by change.	Paid
GET`/api/v1/changes?companies=a,b,c&since=YYYY-MM-DD`	New SEC filings and new Mention Index filings since a date.	Paid
GET`/api/v1/etfs/{ticker}`	Holdings of a tracked ETF: directory companies with weights, top holdings, as-of date and issuer source file.	Paid
GET`/api/v1/exposure/{slug}`	Which tracked ETFs hold a company, with weights and as-of dates.	Paid
GET`/api/v1/screen?category=&listed=&etf=&theme=&min_rate=&rising=true&group=`	Screen companies by category, listing status, ETF, theme, minimum mention rate or rising mentions.	Paid
GET`/api/v1/places?near=lat,lng&radius_km=&type=&country=&limit=`	Public places where robotics and AI can be seen in person. near sorts by straight-line distance (radius_km default 100); type is one of robotaxi, restaurant, museum, showroom, factory-tour, delivery-robots, event; country is a name or ISO code.	Paid
GET`/api/v1/places/{slug}`	One place: what you can see, address, coordinates and precision, website/booking URL, cost, access notes, event timing, related companies, source URLs and last verified date.	Paid

Groups: ai, robots, physical (physical AI). Rates are mentions per 10,000 words; change is in rate points versus the previous comparable filing (annual vs annual, 10-Q vs 10-Q, 6-K vs 6-K). See the Mention Index methodology. The free sample covers nvidia, tesla, intuitive-surgical and BOTZ, place search (5 rows) and the places waymo-robotaxi-denver, computer-history-museum-ai-robotics-gallery, automate. Place coordinates are the venue, or the city centre for service areas (geo_precision); hours are not listed. See Where to see it.

MCP server

Remote MCP over Streamable HTTP at https://airoboticsdirectory.com/mcp. Stateless: no session needed. Tools mirror the API, and paid tools follow the same payment rules.

Client config

For MCP clients that accept a remote server URL (for example Claude, Cursor or VS Code):

{
  "mcpServers": {
    "ai-robotics-directory": {
      "url": "https://airoboticsdirectory.com/mcp"
    }
  }
}

With an API key:

{
  "mcpServers": {
    "ai-robotics-directory": {
      "url": "https://airoboticsdirectory.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

Tools

list_companies FreeAll companies with slug, name, category and ticker.
sample_company FreeCompany snapshot for nvidia, tesla, intuitive-surgical.
sample_places FreePlace search (max 5 rows) or one of waymo-robotaxi-denver, computer-history-museum-ai-robotics-gallery, automate.
api_info FreePricing, payment status and data dates.
get_company PaidCompany snapshot (mirrors /companies/{slug}).
get_mention_history PaidMention history (mirrors /mentions/{slug}).
mention_leaderboard PaidLeaderboard (mirrors /mentions).
get_changes PaidChanges since a date (mirrors /changes).
get_etf PaidETF holdings (mirrors /etfs/{ticker}).
get_exposure PaidETF exposure (mirrors /exposure/{slug}).
screen_companies PaidScreening (mirrors /screen).
search_places PaidPlaces to see robotics and AI in person (mirrors /places).
get_place PaidOne place in full (mirrors /places/{slug}).

curl -X POST https://airoboticsdirectory.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Discovery and Markdown

Machine-readable entry points for agents, crawlers and tools. All public, no key needed.

What	Where
Site summary for LLMs	`/llms.txt`, `/llms-full.txt`
Markdown version of a page	Add `.md` (for example `/companies/nvidia.md`, `/index.md`) or send `Accept: text/markdown` to the page URL
MCP Server Card	`/mcp/server-card`
AI catalog	`/.well-known/ai-catalog.json`
API catalog (RFC 9727)	`/.well-known/api-catalog`
OpenAPI 3.1	`/api/v1/openapi.json`
Open data files	`/data/companies.json`, `/data/mentions.json`, `/data/places.json`

Free API responses carry RateLimit-Policy and an ETag (send If-None-Match for a 304). CORS is open on the API, MCP, Markdown pages, data files and discovery files.

Pricing

No accounts, no subscriptions needed to start.

Available

Free

The /api/v1/sample endpoints, /api/v1/companies, the OpenAPI spec, the free MCP tools and the open datasets companies.json, mentions.json and places.json. Light per-IP rate limit.

Coming soon

Pay per call

About $0.01 USDC per call with x402: the API answers 402 Payment Required with the payment requirements, your agent pays and retries with a PAYMENT-SIGNATURE header. No account or API key. Failed calls (4xx/5xx) are not settled.

Coming soon

Monthly plan

An API key sent as X-API-Key, for people who prefer a monthly plan (planned at $49/month). Not on sale yet.

Paid access is coming soon. Until then, paid endpoints answer 503 with a pointer to the free sample.

How x402 payments work

An open HTTP payment standard for agents. Works with x402 client libraries such as @x402/fetch.

Call a paid endpoint. The response is 402 with an x402 v2 PaymentRequired object (in the body and, base64-encoded, in the PAYMENT-REQUIRED header): scheme exact, network, USDC asset, amount and the receiving address.
Your client signs a USDC transfer authorisation for that amount and retries with the PAYMENT-SIGNATURE header.
The API has a facilitator verify the payment, returns the data and settles it; the receipt comes back in PAYMENT-RESPONSE.

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});
const res = await pay("https://airoboticsdirectory.com/api/v1/companies/nvidia");

MCP clients pay the same way through the x402 MCP transport: a paid tool returns the payment requirements as a tool error, and the client retries with the payment in _meta["x402/payment"].

Responses and citation

Facts keep their original source URL and as-of date. Please cite the company page and keep the disclaimer.

{
  "data": { "slug": "nvidia", "name": "NVIDIA", "facts": [ { "label": "...", "value": "...", "source_url": "...", "as_of": "..." } ], ... },
  "meta": {
    "source": "AI & Robotics Directory",
    "source_url": "https://airoboticsdirectory.com/companies/nvidia/",
    "data_updated": "2026-11-02",
    "license": "CC BY 4.0",
    "citation": "AI & Robotics Directory, \"NVIDIA\", https://airoboticsdirectory.com/companies/nvidia/ (data 2026-11-02, CC BY 4.0)",
    "sample": true
  },
  "disclaimer": "Informational only. Not investment advice, not a recommendation or signal. Data from public sources (SEC EDGAR, Yahoo Finance, ETF issuer files) may be delayed or wrong; check the linked primary sources."
}

Citation format: AI & Robotics Directory, "<Company name>", https://airoboticsdirectory.com/companies/<slug>/ (data <data_updated>, CC BY 4.0). Data is licensed CC BY 4.0.

Limits and terms

Free endpoints and free MCP calls: about 60 requests per minute per IP; then 429.
Data is refreshed weekly from public sources. Fields that a source could not verify are left out, not estimated.
No support desk. Report data errors through the corrections route on the methodology page.

Not investment advice. Informational only. Not investment advice, not a recommendation or signal. Data from public sources (SEC EDGAR, Yahoo Finance, ETF issuer files) may be delayed or wrong; check the linked primary sources. Full disclaimer.