# AI & Robotics Directory: full guide for AI agents

> A public, source-linked directory of AI and robotics companies, the ETFs that hold them, and the macro themes behind them. Public data only, refreshed weekly (last refresh 2026-11-02). 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.

This file describes how agents can read, query and pay for the data. The short index is at https://airoboticsdirectory.com/llms.txt; human docs at https://airoboticsdirectory.com/developers/.

## What the data is
- 52 AI and robotics companies in 6 categories (humanoids, industrial-automation, service-autonomy, ai-chips, compute-power, sensors) and 6 themes (physical-ai, ai-capex, power-grid, reshoring, autonomy, sensing).
- Per company: qualitative description, listing status, key facts each with a source URL and as-of date (SEC EDGAR, Yahoo Finance, ETF issuer files), recent SEC filings, and the tracked ETFs that hold it.
- 9 tracked ETFs (BOTZ, AIQ, ARKQ, ROBO, SMH, SOXX, KOID, HUMN, GRID) with directory holdings, weights, as-of dates and issuer source files.
- AI & Robots Mention Index: counts of AI, robotics and physical-AI terms in 400 SEC filings by 41 companies since 2023-10-04, per 10,000 words. Rate = group mentions / words x 10,000. Change = latest filing's rate minus the rate in the company's previous comparable filing (annual report vs annual report (10-K/20-F/40-F), 10-Q vs 10-Q, 6-K vs 6-K), in rate points per 10,000 words. Counts of terms, not a signal or recommendation.
- Fields a source could not verify are left out; nothing is estimated.

## Free access (no key, no payment)
- https://airoboticsdirectory.com/data/companies.json: full company dataset (CC BY 4.0)
- https://airoboticsdirectory.com/data/mentions.json: full Mention Index dataset
- https://airoboticsdirectory.com/api/v1/companies: list of slugs
- https://airoboticsdirectory.com/api/v1/sample: free samples with the same response shapes as the paid endpoints, limited to nvidia, tesla, intuitive-surgical, the BOTZ ETF, the places waymo-robotaxi-denver, computer-history-museum-ai-robotics-gallery, automate, or 5 rows
- https://airoboticsdirectory.com/api/v1/openapi.json: OpenAPI 3.1 spec
- Free API endpoints and free MCP calls are rate limited to about 60 requests per minute per IP (HTTP 429 after that).

## REST API
Base URL: https://airoboticsdirectory.com. Every response is JSON shaped { "data": ..., "meta": { source_url, data_updated, license, citation }, "disclaimer": "..." }.

- GET /api/v1 [free]: API index: endpoints, pricing and payment status.
- GET /api/v1/openapi.json [free]: OpenAPI 3.1 specification.
- GET /api/v1/companies [free]: All companies with slug, name, category, ticker and listing status.
- GET /api/v1/sample [free]: 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.
- GET /api/v1/companies/{slug} [paid]: Company snapshot: description, facts with source URLs and as-of dates, ETF membership, recent SEC filings and the latest Mention Index stats.
- GET /api/v1/mentions/{slug} [paid]: 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.
- GET /api/v1/mentions?sort=rate|change&group=ai|robots|physical&limit= [paid]: Mention Index leaderboard, ranked by latest rate or by change.
- GET /api/v1/changes?companies=a,b,c&since=YYYY-MM-DD [paid]: New SEC filings and new Mention Index filings since a date.
- GET /api/v1/etfs/{ticker} [paid]: Holdings of a tracked ETF: directory companies with weights, top holdings, as-of date and issuer source file.
- GET /api/v1/exposure/{slug} [paid]: Which tracked ETFs hold a company, with weights and as-of dates.
- GET /api/v1/screen?category=&listed=&etf=&theme=&min_rate=&rising=true&group= [paid]: Screen companies by category, listing status, ETF, theme, minimum mention rate or rising mentions.
- GET /api/v1/places?near=lat,lng&radius_km=&type=&country=&limit= [paid]: 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.
- GET /api/v1/places/{slug} [paid]: 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.

Parameters: group = ai | robots | physical (physical AI), default ai. sort = rate | change. limit max 100. since = YYYY-MM-DD. listed = true (public) | false | a listing status. min_rate = minimum latest rate per 10,000 words. rising=true keeps companies whose latest rate rose versus the previous comparable filing.

Examples:
```
curl https://airoboticsdirectory.com/api/v1/sample/companies/nvidia
curl "https://airoboticsdirectory.com/api/v1/mentions?sort=change&group=physical&limit=10"
curl "https://airoboticsdirectory.com/api/v1/changes?companies=nvidia,tesla&since=2026-07-01"
curl "https://airoboticsdirectory.com/api/v1/screen?category=ai-chips&listed=true&rising=true"
curl "https://airoboticsdirectory.com/api/v1/sample/places?near=39.74,-104.99&radius_km=100"
curl "https://airoboticsdirectory.com/api/v1/places?type=robotaxi&country=US"
```

## Pricing and payment
- Paid endpoints cost about $0.01 USDC per call, paid with x402 (https://www.x402.org/, protocol version 2, scheme "exact", USDC on Base).
- Status: paid access is coming soon. While it is off, paid endpoints return HTTP 503 with {"error":"payment_unavailable","message":"Paid access coming soon...","free_sample":...}. The live status is in GET /api/v1 (data.payments).
- Flow once live: (1) call the endpoint; (2) receive HTTP 402 with a PaymentRequired object in the body and base64-encoded in the PAYMENT-REQUIRED header (accepts: scheme, network, amount in USDC base units, asset, payTo, maxTimeoutSeconds); (3) sign the payment with an x402 client (for example @x402/fetch with @x402/evm) and retry with the PAYMENT-SIGNATURE header; (4) the data comes back with a PAYMENT-RESPONSE settlement receipt. Calls that fail with 4xx/5xx are not settled.
- Alternative: an API key in the X-API-Key header (a monthly plan for people; not on sale yet). Invalid keys get HTTP 401.
- No accounts are needed for x402 and the site never holds customer funds.

## MCP server
- URL: https://airoboticsdirectory.com/mcp (Streamable HTTP, stateless JSON responses; POST JSON-RPC, no session id needed).
- Discovery: Server Card https://airoboticsdirectory.com/mcp/server-card (application/mcp-server-card+json), AI Catalog https://airoboticsdirectory.com/.well-known/ai-catalog.json.
- Client config: {"mcpServers":{"ai-robotics-directory":{"url":"https://airoboticsdirectory.com/mcp"}}}. Add "headers":{"X-API-Key":"..."} if you have a key.
- Tools:
  - list_companies [free]: All companies with slug, name, category and ticker.
  - sample_company [free]: Company snapshot for nvidia, tesla, intuitive-surgical.
  - sample_places [free]: Place search (max 5 rows) or one of waymo-robotaxi-denver, computer-history-museum-ai-robotics-gallery, automate.
  - api_info [free]: Pricing, payment status and data dates.
  - get_company [paid]: Company snapshot (mirrors /companies/{slug}).
  - get_mention_history [paid]: Mention history (mirrors /mentions/{slug}).
  - mention_leaderboard [paid]: Leaderboard (mirrors /mentions).
  - get_changes [paid]: Changes since a date (mirrors /changes).
  - get_etf [paid]: ETF holdings (mirrors /etfs/{ticker}).
  - get_exposure [paid]: ETF exposure (mirrors /exposure/{slug}).
  - screen_companies [paid]: Screening (mirrors /screen).
  - search_places [paid]: Places to see robotics and AI in person (mirrors /places).
  - get_place [paid]: One place in full (mirrors /places/{slug}).
- Paid tools follow the same rules: X-API-Key header on the MCP request, or x402 through the MCP transport (the tool returns isError with the PaymentRequired object in structuredContent; retry the call with the payment payload in params._meta["x402/payment"]). While payments are off they return "paid access coming soon".

## Markdown pages
- Every main page has a Markdown version: add .md to the path (https://airoboticsdirectory.com/index.md, https://airoboticsdirectory.com/companies.md, https://airoboticsdirectory.com/companies/<slug>.md, https://airoboticsdirectory.com/category/<slug>.md, https://airoboticsdirectory.com/places.md, https://airoboticsdirectory.com/places/<slug>.md, https://airoboticsdirectory.com/mentions.md, https://airoboticsdirectory.com/etfs.md, https://airoboticsdirectory.com/themes.md, https://airoboticsdirectory.com/about.md, https://airoboticsdirectory.com/developers.md, https://airoboticsdirectory.com/digest/<date>.md).
- Or request the HTML URL with "Accept: text/markdown"; the response is the same Markdown (Content-Type text/markdown, Vary: Accept).
- HTML pages link it with <link rel="alternate" type="text/markdown"> and an HTTP Link header.

## Citation
- Format: AI & Robotics Directory, "<Company name>", https://airoboticsdirectory.com/companies/<slug>/ (data <data_updated>, CC BY 4.0)
- Link the company page, keep the source URL and as-of date of any fact you quote, and keep the "not investment advice" context.
- Data license: CC BY 4.0.

## 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.
Full disclaimer: https://airoboticsdirectory.com/about/#disclaimer

## Where to see it (places)
- https://airoboticsdirectory.com/places/: 89 public places where robotics and AI can be seen in person (checked 2026-10-27). Types: robotaxi, restaurant, museum, showroom, factory-tour, delivery-robots, event.
- Dataset: https://airoboticsdirectory.com/data/places.json. Coordinates are the venue, or the city centre for service areas (geo_precision). Cost is free, paid or unknown; hours are not listed.
- Informational only. Listing a place is not an endorsement. Service areas, access, prices and dates change; check the official website and linked sources before visiting. Hours are not listed.
- Places:
  - apollo-go-robotaxi-dubai: Apollo Go robotaxi: Dubai (robotaxi, Dubai, United Arab Emirates)
  - ars-electronica-center-understanding-ai: Ars Electronica Center: Understanding AI (museum, Linz, Upper Austria, Austria)
  - artly-robot-coffee-pike-place-seattle: Artly robot coffee, Pike Place (Seattle) (restaurant, Seattle, Washington)
  - automate: Automate (event, Las Vegas, Nevada)
  - automatica: automatica (event, Munich, Bavaria, Germany)
  - avatar-robot-cafe-dawn-tokyo: Avatar Robot Café DAWN (Tokyo) (restaurant, Tokyo, Japan)
  - barista-bot-robotic-coffee-denver-international-airport: Barista Bot robotic coffee, Denver International Airport (restaurant, Denver, Colorado)
  - beijing-e-town-humanoid-robot-half-marathon: Beijing E-Town Humanoid Robot Half Marathon (event, Beijing, China)
  - bmw-group-plant-munich-tour: BMW Group Plant Munich tour (factory-tour, Munich, Bavaria, Germany)
  - bmw-zentrum-and-ifactory-tour-plant-spartanburg: BMW Zentrum and iFACTORY tour, Plant Spartanburg (factory-tour, Greer, South Carolina)
  - ces: CES (event, Las Vegas, Nevada)
  - cite-des-sciences-et-de-l-industrie-robots: Cité des sciences et de l'industrie: Robots (museum, Paris, Île-de-France, France)
  - coco-delivery-robots-chicago: Coco delivery robots: Chicago (delivery-robots, Chicago, Illinois)
  - coco-delivery-robots-helsinki: Coco delivery robots: Helsinki (delivery-robots, Helsinki, Uusimaa, Finland)
  - coco-delivery-robots-jersey-city: Coco delivery robots: Jersey City (delivery-robots, Jersey City, New Jersey)
  - coco-delivery-robots-los-angeles: Coco delivery robots: Los Angeles (delivery-robots, Los Angeles, California)
  - coco-delivery-robots-miami: Coco delivery robots: Miami (delivery-robots, Miami, Florida)
  - computer-history-museum-ai-robotics-gallery: Computer History Museum: AI & Robotics gallery (museum, Mountain View, California)
  - deutsches-museum-robotics: Deutsches Museum: Robotics (museum, Munich, Bavaria, Germany)
  - donatos-autonomous-pizza-kiosk-john-glenn-columbus-international-airport: Donatos autonomous pizza kiosk, John Glenn Columbus International Airport (restaurant, Columbus, Ohio)
  - doordash-dot-delivery-robots-tempe-and-mesa: DoorDash Dot delivery robots: Tempe and Mesa (delivery-robots, Tempe, Arizona)
  - first-championship: FIRST Championship (event, Houston, Texas)
  - first-robotics-competition-denver-regional: FIRST Robotics Competition: Denver Regional (event, Denver, Colorado)
  - ford-rouge-factory-tour: Ford Rouge Factory Tour (factory-tour, Dearborn, Michigan)
  - hannover-messe: HANNOVER MESSE (event, Hanover, Lower Saxony, Germany)
  - heinz-nixdorf-museumsforum-man-robots: Heinz Nixdorf MuseumsForum: Man, Robots! (museum, Paderborn, North Rhine-Westphalia, Germany)
  - hyundai-motor-manufacturing-alabama-plant-tour: Hyundai Motor Manufacturing Alabama plant tour (factory-tour, Montgomery, Alabama)
  - irex-international-robot-exhibition: iREX International Robot Exhibition (event, Tokyo, Japan)
  - javai-robotic-coffee-kiosk-denver-international-airport: JAVAI robotic coffee kiosk, Denver International Airport (restaurant, Denver, Colorado)
  - kamin-science-center-robot-hall-of-fame: Kamin Science Center: Robot Hall of Fame (museum, Pittsburgh, Pennsylvania)
  - kawasaki-robostage: Kawasaki Robostage (showroom, Tokyo, Japan)
  - mercedes-benz-visitor-center-and-plant-tour-vance: Mercedes-Benz Visitor Center and plant tour, Vance (factory-tour, Vance, Alabama)
  - mit-museum-ai-mind-the-gap: MIT Museum: AI: Mind the Gap (museum, Cambridge, Massachusetts)
  - museum-of-science-boston-exploring-ai: Museum of Science, Boston: Exploring AI (museum, Boston, Massachusetts)
  - nvidia-gtc: NVIDIA GTC (event, San Jose, California)
  - pony-ai-robotaxi-beijing: Pony.ai robotaxi: Beijing (robotaxi, Beijing, China)
  - pony-ai-robotaxi-guangzhou: Pony.ai robotaxi: Guangzhou (robotaxi, Guangzhou, Guangdong, China)
  - pony-ai-robotaxi-shenzhen: Pony.ai robotaxi: Shenzhen (robotaxi, Shenzhen, Guangdong, China)
  - porsche-leipzig-factory-tour: Porsche Leipzig factory tour (factory-tour, Leipzig, Saxony, Germany)
  - promat: ProMat (event, Chicago, Illinois)
  - robocup: RoboCup (event, Nuremberg, Bavaria, Germany)
  - robot-mall-robot-4s-store-beijing-e-town: Robot Mall (Robot 4S Store), Beijing E-Town (showroom, Beijing, China)
  - robot-riot-the-robot-comedy-hour: Robot Riot: The Robot Comedy Hour (event, Denver, Colorado)
  - robotics-summit-expo: Robotics Summit & Expo (event, Boston, Massachusetts)
  - robobusiness: Robotics Summit & Expo West (formerly RoboBusiness) (event, Santa Clara, California)
  - seoul-robot-ai-museum-raim: Seoul Robot & AI Museum (RAIM) (museum, Seoul, South Korea)
  - serve-robotics-delivery-robots-alexandria: Serve Robotics delivery robots: Alexandria (delivery-robots, Alexandria, Virginia)
  - serve-robotics-delivery-robots-atlanta: Serve Robotics delivery robots: Atlanta (delivery-robots, Atlanta, Georgia)
  - serve-robotics-delivery-robots-chicago: Serve Robotics delivery robots: Chicago (delivery-robots, Chicago, Illinois)
  - serve-robotics-delivery-robots-dallas-fort-worth: Serve Robotics delivery robots: Dallas–Fort Worth (delivery-robots, Dallas–Fort Worth, Texas)
  - serve-robotics-delivery-robots-los-angeles: Serve Robotics delivery robots: Los Angeles (delivery-robots, Los Angeles, California)
  - serve-robotics-delivery-robots-miami: Serve Robotics delivery robots: Miami (delivery-robots, Miami, Florida)
  - starship-delivery-robots-leeds: Starship delivery robots: Leeds (delivery-robots, Leeds, England, United Kingdom)
  - starship-delivery-robots-milton-keynes: Starship delivery robots: Milton Keynes (delivery-robots, Milton Keynes, England, United Kingdom)
  - starship-delivery-robots-tallinn: Starship delivery robots: Tallinn (delivery-robots, Tallinn, Harju County, Estonia)
  - tesla-robotaxi-austin: Tesla Robotaxi: Austin (robotaxi, Austin, Texas)
  - tesla-robotaxi-dallas: Tesla Robotaxi: Dallas (robotaxi, Dallas, Texas)
  - tesla-robotaxi-houston: Tesla Robotaxi: Houston (robotaxi, Houston, Texas)
  - tesla-robotaxi-miami: Tesla Robotaxi: Miami (robotaxi, Miami, Florida)
  - tesla-robotaxi-orlando: Tesla Robotaxi: Orlando (robotaxi, Orlando, Florida)
  - tesla-robotaxi-tampa: Tesla Robotaxi: Tampa (robotaxi, Tampa, Florida)
  - the-tech-interactive-social-robots-and-dream-garden: The Tech Interactive: Social Robots and Dream Garden (museum, San Jose, California)
  - toyota-commemorative-museum-of-industry-and-technology: Toyota Commemorative Museum of Industry and Technology (museum, Nagoya, Aichi, Japan)
  - toyota-kentucky-experience-center-and-plant-tour: Toyota Kentucky Experience Center and plant tour (factory-tour, Georgetown, Kentucky)
  - volkswagen-factorytour-compact-wolfsburg: Volkswagen FactoryTour Compact, Wolfsburg (factory-tour, Wolfsburg, Lower Saxony, Germany)
  - waymo-on-uber-atlanta: Waymo on Uber: Atlanta (robotaxi, Atlanta, Georgia)
  - waymo-on-uber-austin: Waymo on Uber: Austin (robotaxi, Austin, Texas)
  - waymo-robotaxi-dallas: Waymo robotaxi: Dallas (robotaxi, Dallas, Texas)
  - waymo-robotaxi-denver: Waymo robotaxi: Denver (robotaxi, Denver, Colorado)
  - waymo-robotaxi-houston: Waymo robotaxi: Houston (robotaxi, Houston, Texas)
  - waymo-robotaxi-las-vegas: Waymo robotaxi: Las Vegas (robotaxi, Las Vegas, Nevada)
  - waymo-robotaxi-los-angeles: Waymo robotaxi: Los Angeles (robotaxi, Los Angeles, California)
  - waymo-robotaxi-metro-phoenix: Waymo robotaxi: Metro Phoenix (robotaxi, Phoenix, Arizona)
  - waymo-robotaxi-miami: Waymo robotaxi: Miami (robotaxi, Miami, Florida)
  - waymo-robotaxi-nashville: Waymo robotaxi: Nashville (robotaxi, Nashville, Tennessee)
  - waymo-robotaxi-orlando: Waymo robotaxi: Orlando (robotaxi, Orlando, Florida)
  - waymo-robotaxi-san-antonio: Waymo robotaxi: San Antonio (robotaxi, San Antonio, Texas)
  - waymo-robotaxi-san-diego: Waymo robotaxi: San Diego (robotaxi, San Diego, California)
  - waymo-robotaxi-san-francisco-bay-area: Waymo robotaxi: San Francisco Bay Area (robotaxi, San Francisco, California)
  - waymo-robotaxi-tampa: Waymo robotaxi: Tampa (robotaxi, Tampa, Florida)
  - weride-robotaxi-on-uber-abu-dhabi: WeRide robotaxi on Uber: Abu Dhabi (robotaxi, Abu Dhabi, United Arab Emirates)
  - weride-robotaxi-on-uber-dubai: WeRide robotaxi on Uber: Dubai (robotaxi, Dubai, United Arab Emirates)
  - weride-robotaxi-on-uber-riyadh: WeRide robotaxi on Uber: Riyadh (robotaxi, Riyadh, Riyadh Province, Saudi Arabia)
  - world-artificial-intelligence-conference-waic: World Artificial Intelligence Conference (WAIC) (event, Shanghai, China)
  - world-humanoid-robot-games: World Humanoid Robot Games (event, Beijing, China)
  - world-robot-conference: World Robot Conference (event, Beijing, China)
  - yaskawa-innovation-center-robot-village: YASKAWA Innovation Center (Robot Village) (showroom, Kitakyushu, Fukuoka, Japan)
  - zoox-robotaxi-las-vegas: Zoox robotaxi: Las Vegas (robotaxi, Las Vegas, Nevada)
  - zoox-robotaxi-san-francisco: Zoox robotaxi: San Francisco (robotaxi, San Francisco, California)

## Company slugs
- aeva-technologies: Aeva Technologies (AEVA), sensors
- agility-robotics: Agility Robotics (pending listing (SPAC)), humanoids
- ambarella: Ambarella (AMBA), ai-chips
- amd: AMD (AMD), ai-chips
- apptronik: Apptronik (private), humanoids
- arista-networks: Arista Networks (ANET), compute-power
- arm-holdings: Arm Holdings (ARM), ai-chips
- asml: ASML (ASML), ai-chips
- aurora-innovation: Aurora Innovation (AUR), service-autonomy
- broadcom: Broadcom (AVGO), ai-chips
- cameco: Cameco (CCJ), compute-power
- cerebras-systems: Cerebras Systems (CBRS), ai-chips
- cognex: Cognex (CGNX), sensors
- constellation-energy: Constellation Energy (CEG), compute-power
- coreweave: CoreWeave (CRWV), compute-power
- doosan-robotics: Doosan Robotics (454910.KS), industrial-automation
- eaton: Eaton (ETN), compute-power
- fanuc: FANUC (6954.T), industrial-automation
- figure-ai: Figure AI (private), humanoids
- ge-vernova: GE Vernova (GEV), compute-power
- harmonic-drive-systems: Harmonic Drive Systems (6324.T), industrial-automation
- hesai-group: Hesai Group (HSAI), sensors
- innoviz-technologies: Innoviz Technologies (INVZ), sensors
- intuitive-surgical: Intuitive Surgical (ISRG), service-autonomy
- keyence: Keyence (6861.T), industrial-automation
- marvell-technology: Marvell Technology (MRVL), ai-chips
- micron-technology: Micron Technology (MU), ai-chips
- mobileye: Mobileye (MBLY), service-autonomy
- novanta: Novanta (NOVT), sensors
- nvidia: NVIDIA (NVDA), ai-chips
- oklo: Oklo (OKLO), compute-power
- ouster: Ouster (OUST), sensors
- pony-ai: Pony AI (PONY), service-autonomy
- qualcomm: Qualcomm (QCOM), ai-chips
- rockwell-automation: Rockwell Automation (ROK), industrial-automation
- serve-robotics: Serve Robotics (SERV), service-autonomy
- siemens: Siemens (SIE.DE), industrial-automation
- sony-group: Sony Group (SONY), sensors
- super-micro-computer: Super Micro Computer (SMCI), compute-power
- symbotic: Symbotic (SYM), industrial-automation
- teledyne-technologies: Teledyne Technologies (TDY), sensors
- teradyne: Teradyne (TER), industrial-automation
- tesla: Tesla (TSLA), humanoids
- tsmc: TSMC (TSM), ai-chips
- ubtech-robotics: UBTech Robotics (9880.HK), humanoids
- unitree-robotics: Unitree Robotics (688836.SS), humanoids
- vertiv: Vertiv (VRT), compute-power
- vistra: Vistra (VST), compute-power
- weride: WeRide (WRD), service-autonomy
- xpeng: XPeng (XPEV), humanoids
- yaskawa-electric: Yaskawa Electric (6506.T), industrial-automation
- zebra-technologies: Zebra Technologies (ZBRA), industrial-automation