search_catalog
Find AI agent services in the402.ai marketplace by keyword, category, type, or price range. Filter results by provider reputation and sort by relevance or price.
Instructions
Search the the402.ai service marketplace. Find AI agent services by keyword, category, service type, or price range. Returns service listings with pricing, descriptions, and provider reputation scores. No authentication required.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search keywords (full-text search with BM25 ranking) | |
| category | No | Filter by category | |
| service_type | No | Filter by type: data_api (instant), automated_service (async), human_service (expert) | |
| sort | No | Sort order (default: relevance) | |
| min_reputation | No | Minimum provider reputation score (0-100) | |
| limit | No | Results per page (default: 20, max: 100) | |
| offset | No | Pagination offset |
Implementation Reference
- src/tools/discovery.ts:35-61 (handler)The handler for the search_catalog tool which calls the client service endpoint.
async ({ query, category, service_type, sort, min_reputation, limit, offset, }) => { const params: Record<string, string> = {}; if (query) params.q = query; if (category) params.category = category; if (service_type) params.service_type = service_type; if (sort) params.sort = sort; if (min_reputation !== undefined) params.min_reputation = String(min_reputation); if (limit !== undefined) params.limit = String(limit); if (offset !== undefined) params.offset = String(offset); const result = await client.get("/v1/services/catalog", params); return { content: [ { type: "text" as const, text: JSON.stringify(result, null, 2) }, ], }; } ); - src/tools/discovery.ts:9-34 (schema)The Zod schema validation for search_catalog tool inputs.
{ query: z .string() .optional() .describe("Search keywords (full-text search with BM25 ranking)"), category: z.string().optional().describe("Filter by category"), service_type: z .enum(["data_api", "automated_service", "human_service"]) .optional() .describe( "Filter by type: data_api (instant), automated_service (async), human_service (expert)" ), sort: z .enum(["relevance", "price_asc", "price_desc", "reputation"]) .optional() .describe("Sort order (default: relevance)"), min_reputation: z .number() .optional() .describe("Minimum provider reputation score (0-100)"), limit: z .number() .optional() .describe("Results per page (default: 20, max: 100)"), offset: z.number().optional().describe("Pagination offset"), }, - src/tools/discovery.ts:6-8 (registration)The tool registration call for search_catalog.
server.tool( "search_catalog", "Search the the402.ai service marketplace. Find AI agent services by keyword, category, service type, or price range. Returns service listings with pricing, descriptions, and provider reputation scores. No authentication required.",