the402-mcp-server

Instructions

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.",