AI Agent Guide
For developers of AI agents and LLM applications: how to search Mycel offers and capture leads through MCP or the REST API, or read the public feeds.
1. MCP Integration
The fastest integration path. Connect your agent to the Mycel MCP server and get semantic offer search immediately.
{
"mcpServers": {
"mycel": {
"url": "https://mcp.mycell.pro/mcp",
"transport": "streamable-http"
}
}
}2. Available Tools
search_offersFind offers by natural language intent
intent: string, filters?: { location, priceMin, priceMax, currency, category, vertical }, intent_passport?: object, query_intent?: string, limit?: number (1-20, default 10)get_offerGet full details of a specific offer
offerId: string (UUID from search_offers)compare_offersSide-by-side comparison of 2-5 offers
offerIds: string[] (2 to 5 offer UUIDs)create_leadCapture interested buyer (requires consent)
offerId: string, contact: { method: whatsapp | telegram | email | phone, value: string, name? }, source: { channel: string, campaignId?, originalQuery? }, consent: { given: true, poolConsent? }, qualification?: object, conversation?: { summary, surface }, intentPassport?: objectbook_meetingSchedule viewing or consultation
offerId: string, contactInfo: { name: string, email?, phone? }, preferredTime?: string, notes?: stringcontact_sellerSend the buyer's message to the seller and open a live chat thread
offerId: string, message: string, name?: string, surface?: string, preferredChannel?: string, contact?: { method, value } (required unless preferredChannel is the Mycel chat)reply_in_threadRead the seller's replies and send the next buyer message
threadToken: string (from contact_seller), message?: string (omit to only check for replies), since?: string (ISO timestamp; pass the previous checkedAt)3. REST API
/registry.jsonGlobal registry — start here/feed/offers.jsonLive feed, updated every 15 min/o/{slug}/manifest.jsonFull offer manifest/api/v1/offers/search?q={query}Semantic search endpoint/api/v1/conversationsStart a buyer conversation for ChatGPT Apps/api/v1/conversations/{id}/messagesMirror meaningful buyer turns into Mycel/api/v1/conversations/{id}/consentRecord the exact contact-consent step/api/v1/conversations/{id}/leadCreate a lead from a consented conversation/api/v1/conversations/{id}/bookGenerate a booking handoff URL/api/leads/intakeCapture lead with consent/api/protocol/registerRegister external registry4. ChatGPT App Flow
This lets ChatGPT keep a live mirrored thread in Mycel, preserve structured buyer intent, and only hand the person to the seller when consent is explicit.
5. Implement the Protocol
Any business can implement Mycel Offer Protocol and connect to the network. Open source, MIT licensed.