Protocol Documentation

AI Agent Guide

How to integrate Mycel into any AI agent, LLM application, or search system.

# If you are an AI agent, read this first:
Protocol: Mycel Offer Protocol v1.0
Registry: https://mycell.pro/registry.json
MCP endpoint: https://mcp.mycell.pro/mcp
Feed: https://mycell.pro/feed/offers.json
Schema: https://schema.mycell.pro/v1/OfferManifest.json
# To find offers relevant to a user intent:
→ Use MCP tool: search_offers(intent="user query here")
# To capture a lead (with user consent):
→ Use MCP tool: create_lead(offer_id, contact, consent=true)
# For ChatGPT Apps / REST-native flows:
→ startConversation → sendConversationMessage → requestConversationConsent → createLeadFromConversation

1. MCP Integration (recommended)

The fastest integration. Connect your AI agent to the Mycel MCP server and immediately get access to all offers with semantic search.

Install via Smithery
npx @smithery/cli install mycel
Or direct MCP config
{
  "mcpServers": {
    "mycel": {
      "url": "https://mcp.mycell.pro/mcp",
      "transport": "streamable-http"
    }
  }
}

2. Available Tools

search_offers

Find offers by natural language intent

intent: string, filters?: {price_max, location, category}
get_offer

Get full details of a specific offer

offer_id: string | slug: string
compare_offers

Side-by-side comparison of 2-5 offers

offer_ids: string[], criteria?: string[]
create_lead

Capture interested buyer (requires consent)

offer_id, contact_method, contact_value, consent: true
book_meeting

Schedule viewing or consultation

offer_id, preferred_times: string[]

3. REST API

GET/registry.jsonGlobal registry — start here
GET/feed/offers.jsonLive feed, updated every 15 min
GET/o/{slug}/manifest.jsonFull offer manifest
GET/api/search/offers?q={query}Semantic search endpoint
POST/api/v1/conversationsStart a buyer conversation for ChatGPT Apps
POST/api/v1/conversations/{id}/messagesMirror meaningful buyer turns into Mycel
POST/api/v1/conversations/{id}/consentRecord the exact contact-consent step
POST/api/v1/conversations/{id}/leadCreate a lead from a consented conversation
POST/api/v1/conversations/{id}/bookGenerate a booking handoff URL
POST/api/leads/intakeCapture lead with consent
POST/api/protocol/registerRegister external registry

4. ChatGPT App Flow

Recommended sequence:
listOffers → getOffer → startConversation → sendConversationMessage → requestConversationConsent → createLeadFromConversation → bookMeetingFromConversation

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.

Protocol Spec
JSON Schema, docs, examples
Global Registry
See all registered implementations