Protocol docs

AI Agent Guide

How to integrate Mycel into an AI agent, LLM application, or search workflow without dropping into a separate visual system from the rest of the product.

Start free trial View pricing

# 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

The fastest integration path. Connect your agent to the Mycel MCP server and get semantic offer search immediately.

Install via Smithery

npx @smithery/cli install mycel

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