Introduction
Welcome to the Recall Kitchen Developer Documentation. This site provides resources for integrating with Recall Kitchen's services programmatically.
Recall Kitchen offers an API and Agent integrations (MCP, MPP, x402) for searching product recalls, ensuring safety in consumer products.
Overview
Our platform supports:
- Model Context Protocol (MCP) and Machine Payments Protocol (MPP) for AI agent integrations
- REST API (coming soon)
Getting Started
To start developing with Recall Kitchen, you'll need:
- An API key (contact support)
- Familiarity with HTTP APIs or MCP/MPP
Authentication
Authentication methods vary by integration. For MCP, MPP, and x402, payments are handled via blockchain.
- MCP and MPP requires USDC payments with the x402 protocol
- API requets require an API key
Agent Integrations (MCP, MPP, x402)
Recall Kitchen integrates with the Model Context Protocol (MCP) and Machine Payment Protocol (MPP) standards for tool use by AI models. Our MCP implementation leverages x402 (USDC on Base) for micropayments, enabling paid access to tools.
MCP
search_product_recalls: Searches for product recalls based on a query string.
- Input:
{ "query": "string", "limit": number } - Output: List of recalls with ID, source, title, description, URL, published date.
- Price: $0.025 per call
x402 Payments
To access the MCP tools x402 payments are required. Recall Kitchen currently supports USDC on Base.
MCP Endpoints
Recall Kitchen's MCP endpoint is https://app.recallkitchen.com/mcp
Examples
To use MCP with x402:
- Check out our examples using MCP.
MPP
Coming Soon -
API Reference
Recall Kitchen's REST API is currently in development. We're not ready to offer a full public API yet, but stay tuned for updates.
If you would like Beta access and to contribute to the API design reach out to us.
Planned endpoints:
GET /recalls- Search recallsPOST /scan- Scan images for products and recalls
Contact [email protected] for early access.
SDKs
We provide SDKs for popular languages:
- Go
- Coming soon: Python, JavaScript
- Tell us what languages to support next.
Examples
MCP Tool Usage
Payment Flow
Payments are handled automatically via x402 for MCP. Users pay per tool call on supported networks.
FAQ
What recalls do you support?
We currently ingest United States CPSC, FDA, and USDA food recalls.