Search Products
search_productsSearch AI-native products by free text,
membership (category, job-to-be-done, capability, publisher organization or
person, SDK language,
license, certification, access control, agent skill, benchmark,
documentation resource, MFA type), AI-native tier, active-offer
billing_model/payment_method, or affordance booleans (has_mcp
selects hosted MCP servers; has_mcp_url narrows that to a dialable endpoint
url; has_api_spec and spec_type select API
specs). Membership and reference filters take one slug or an array (OR
within a filter; filters combine with AND). view="compact" returns a curated
shortlist projection for a first pass (identity, the rating and coverage
signals, the affordance booleans, and the connect summary) and cannot combine
with fields; fields trims the payload to an explicit set and expand
resolves relation *_ids into inline objects. Returns a
cursor-paginated page whose products carry ai_native_score (0-100),
ai_native_tier (S/A/B/C/D), the research-coverage axis coverage_score
(0-100) and derived unrated boolean, the attested_absences list, and
the read booleans has_mcp, has_mcp_url, has_sdk, has_api_spec,
has_cli, and has_a2a (each reports catalog record presence),
and free_plan (True when the product has an active free-tier offer; null
when none is recorded,
so rank a shortlist by cost without opening each product — the value is never
false because offers carry no attested absence). Evidence-based filters exclude
unknown values in both directions. Negative relation filters require whole-relation
absence evidence. Negative offer filters return zero matches until offer absence
is supported. Read presence booleans alone do not establish filter evidence.
The page carries filter_breakdown: matched, recorded_nonmatch, and
unknown counts for each supported filter. Previously covered positive requests
also retain recorded_negative as an alias of recorded_nonmatch.
Sum only the three canonical counts. Refinements include spec_type,
sdk_language, has_mcp_url, every data_export set, and certification,
access-control, or agent-skill membership. A different relation member leaves
the requested value unknown. get_product has the full reading guidance.
The REST *_id
UUID filters and the web-only following filter are intentionally not exposed
here; use the HTTP API for those.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | AI-native tier: S, A, B, C, D, or Unrated. A letter matches only products whose coverage clears the research threshold; Unrated matches the rest. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| view | No | Opt-in named projection, mirroring the REST `view` parameter. `compact` returns the shortlist field set for a first pass: product identity, the ai_native_tier, ai_native_score, coverage_score, and unrated rating signals, the has_* affordance booleans, and the connect summary. It omits the *_ids arrays and the null-heavy decision scalars. Pagination, the weak-match signal, and the suggested categories and jobs are unchanged. Cannot combine with fields. Omit for the full record. | |
| query | No | Deprecated alias for search; renames to the same catalog parameter. Use search instead (ADR-0033). | |
| cursor | No | Opaque cursor from a previous page's response. | |
| expand | No | Comma-separated product relations to expand inline as full objects rather than opaque *_ids, following the REST ?expand= grammar. Example: mcp_servers,developer_kits,capabilities. Lets you resolve a result's affordance IDs (SDK languages, spec URLs, MCP endpoints) without a follow-up get_product call. An invalid value returns the allowed set. Omit it for the lighter id-only page. | |
| fields | No | Comma-separated top-level response fields to include, following the REST ?fields= grammar. The response always keeps id. Narrows the payload for compact reads; an expanded relation is still returned only when its field is in the selection. Omit for the full record. | |
| pay_go | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| person | No | Filter by publisher person slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| search | No | Free-text search across products. Search matches product name, description, and related capability and job-to-be-done names by meaning, so query the capability a product provides, such as "weather forecast", not the user's whole goal, such as "plan a family outing based on weather". When set, the response carries a page-level `strong_match` boolean: `false` means every returned product surfaced only through approximate meaning-similarity, or there were none, so narrow the search before relying on a result. On a `false` match the response also lists `suggested_categories` and `suggested_jobs_to_be_done` (lexical matches most-populated first, semantic matches nearest-intent first; each with a `product_count` and a `match_kind`) — pass a suggestion's slug to the matching filter to switch from free-text search to exact membership. `match_kind` is `lexical` when the term's label contained your wording and `semantic` when it is a close match on intent worth checking. An empty suggestion list means neither your wording nor its intent matched a term; retry with a shorter query or browse the taxonomy. | |
| has_a2a | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| has_cli | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| has_mcp | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| has_sdk | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| license | No | Filter by license slug, e.g. apache-2-0. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| sandbox | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| web_mcp | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| category | No | Filter by category slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| mfa_type | No | Filter by multi-factor-auth type slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| benchmark | No | Filter by benchmark slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| free_plan | No | True matches products with an active Offer containing a structured pricing option with price_kind: free. False returns zero matches until the catalog supports offer absence. Missing offers remain unknown. Omit to leave unfiltered. Prose-only free allowances do not match without a qualifying structured option. Offers can have quotas, eligibility restrictions, noncommercial terms, or attribution requirements. Inspect offer terms and url. Example: search_products(free_plan=true, expand="offers"). Accepts true/false, 1/0, yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. | |
| page_size | No | Results per page (1-100). | |
| spec_type | No | API specification type: openapi, grpc, or graphql. Supply an array for OR matching. Invalid values return the allowed set. | |
| capability | No | Deprecated alias for capability_slug. Supply only one spelling. | |
| agent_skill | No | Filter by agent-skill slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| data_export | No | Recorded data export support: full, partial, or none. Supply an array for OR matching. Unknown values are excluded. | |
| has_mcp_url | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| no_training | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| open_source | No | Matches the recorded boolean; excludes unknown. Accepts true/false, 1/0, yes/no, or on/off, ignoring case and whitespace. Omit to leave unfiltered. | |
| has_api_spec | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| organization | No | Filter by publisher organization slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| sdk_language | No | Filter by a product SDK's programming-language slug, e.g. python. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| billing_model | No | Filter by an active offer's billing-model slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| certification | No | Filter by compliance certification slug, e.g. soc-2. List tool: list_compliance_certifications. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| self_hostable | No | Matches the recorded boolean; excludes unknown. Accepts true/false, 1/0, yes/no, or on/off, ignoring case and whitespace. Omit to leave unfiltered. | |
| access_control | No | Filter by access-control slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| job_to_be_done | No | Filter by job-to-be-done slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| open_standards | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| payment_method | No | Filter by an active offer's payment-method slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| capability_slug | No | Filter by capability slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. | |
| headless_signup | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| zero_data_retention | No | Accepts true/false, 1/0 (JSON boolean or number), yes/no, or on/off, ignoring case and surrounding whitespace. Empty values are invalid. Omit to leave unfiltered. | |
| documentation_resource | No | Filter by documentation-resource slug. Accepts one slug or a nonempty array of slugs; an array matches any (OR). Separate filters combine with AND. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||