Airframe DocsTools reference
The seven Airframe MCP tools, their parameters, and what each returns.
Airframe exposes seven tools. All of them are read-only: none creates, changes, or deletes anything. Each is annotated readOnlyHint: true, so clients that auto-approve read-only tools can run them without asking each time.
The live tool list your client receives when it connects is authoritative. This page describes it.
| Tool | Use it for | Metered |
|---|---|---|
search_products | Find products by keyword, category, or department, and resolve names to slugs | Yes |
get_product_details | Full profiles of 1–5 products | Yes |
find_experts | Practitioners with hands-on experience of a product or area | Yes |
ask_airframe | Free-form questions answered from the catalog | Yes, with tighter limits |
list_market_reports | The market reports your team can read | Yes |
read_market_report_section | Exact data from one section of a report | Yes |
get_my_usage | Your team's usage and quotas | No |
Product tools take slugs, not names. Your assistant resolves a name with search_products first. Airframe never guesses: an unknown slug, filter, market, or section is rejected with the closest valid values, so the assistant can retry with one of them.
search_products
Search the catalog of 7,300+ software products. Returns matching products with descriptions, categories, vendor names, Airframe URLs, and the slug the other tools take.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Descriptive words, such as a product name or "AI SDR tool" |
category | string | No | An Airframe category name, such as Customer Service CRM (CSM) |
department | string | No | The buying function, such as Marketing, Finance, or Customer Support |
limit | integer | No | Results to return. Default 10, maximum 25 |
Filters are exact. An unrecognized filter value is rejected with the closest valid values. An empty result means no product matched.
Example prompt: "Is there software for SOC 2 automation?"
get_product_details
Airframe's current profile of 1–5 products: vendor firmographics and funding, positioning and ideal customer, features, integrations, pricing, compliance, list price and median estimated annual contract value, review pros and cons, expert-network size, and known alternatives.
| Parameter | Type | Required | Description |
|---|---|---|---|
product_slugs | string[] | Yes | 1–5 catalog slugs, such as ["zendesk-com-service", "decagon-ai"]. Pass every product of a comparison in one call |
sections | string[] | No | Limit each profile to what the task needs. Any of overview, vendor, classification, positioning, fipc, pricing, reviews, experts, alternatives. Omit for the full profile |
fipc covers features, integrations, pricing, and compliance, including the vendor's published pricing tiers. The median estimated contract value under pricing is Airframe's modeled estimate, not a quoted price.
Example prompt: "What does Zendesk cost, and how does that compare with Intercom?"
find_experts
Search Airframe's network of 30,000+ software practitioners by expertise or product experience. Returns anonymized profiles with expertise areas and product experience. Contact Airframe for introductions.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | The expertise you're looking for |
product | string | No | Restrict to people with hands-on experience of one catalog product, by name or slug |
limit | integer | No | Results to return. Default 10, maximum 15 |
Example prompt: "Find someone who has deployed Gong at enterprise scale."
ask_airframe
Ask any question about software products, markets, vendors, or technology decisions. Answers are grounded in Airframe's data and cite their sources. Use it for multi-part questions, build-versus-buy analysis, recommendations, market overviews, and writing tasks that depend on company facts.
| Parameter | Type | Required | Description |
|---|---|---|---|
question | string | Yes | The question, in plain language |
Very broad questions get a clarifying prompt. Questions outside Airframe's scope fall back to general knowledge.
Example prompt: "Should a 200-person fintech build or buy an eval harness?"
list_market_reports
List the market reports your team is entitled to and the sections each one has. Returns each market's slug (the only value read_market_report_section accepts), its label, and what each section answers. Requires OAuth sign-in.
No parameters.
Example prompt: "What market research do we have?"
read_market_report_section
Read exact data from one section of an entitled market report, in bounded slices.
| Parameter | Type | Required | Description |
|---|---|---|---|
market_slug | string | Yes | A slug from list_market_reports |
section | string | Yes | One of meta, vendors, overview, firmographic, adoption, customer-stack, company-stacks, industry-kpi, switches, messaging, winloss, visibility, integration, partnership, verticals, recommendation, bottomlines, rfp, best-practices, recent-acquisitions |
path | string | No | A dot path into the section, such as groups.0.vendors |
keys | string[] | No | Fields to keep from an object |
offset | integer | No | Where to start in a list. Default 0 |
limit | integer | No | Rows to return. Default 25, maximum 200 |
List data returns a total; page on while total exceeds offset + limit. When a slice is too large, the response is an outline of its shape instead of data, so the assistant can narrow it with path or keys. Unknown markets, sections, paths, and keys are errors, never empty data.
Example prompt: "Who are the main vendors in the AI voice agent market, and what are buyers switching from?"
get_my_usage
Show your team's successful calls this month and any per-minute, per-day, or per-month quotas with their remaining capacity. This tool isn't metered, so it still works after you reach a quota.
No parameters.
Example prompt: "How much Airframe have I used this month?"