← Setup instructions
Headlo MCP — All 23 Tools
Available through the Headlo MCP server. Connect from Claude Code, Claude.ai, Cursor, Windsurf, or any MCP-compatible platform.
https://api.headlo.com/v1/mcp
CMS & Collections— Agency auth required
- headlo_list_collectionsList all collections available for this agency.
- headlo_list_recordsList records in a specific collection.
- headlo_upsert_collectionCreate or update a collection schema.
- headlo_get_collectionGet the schema (field names and types) for a collection.
- headlo_create_recordCreate a new record in a collection.
- headlo_create_records_bulkCreate multiple records in a collection in one call.
- headlo_search_productsSearch the store product catalog using a natural language query.
- headlo_list_approved_endpointsList approved external API endpoints configured for this agency.
- http_requestMake an HTTP request to an approved external endpoint.
JS Components— Agency auth required
- headlo_list_componentsList all components available for this agency.
- headlo_read_componentRead the full code and metadata of a component.
- headlo_update_componentUpdate the code of a component.
- headlo_upload_media_from_urlDownload an image from a URL and upload it to Headlo media storage. Returns media_id and alt.
Store & Commerce
- create_shopCreate a new online store. Returns storefront URL + dashboard URL emailed to the owner.
- update_shopUpdate shop settings (brand name, description, custom domain, return address).
- fetch_etsy_listingFetch product data from an Etsy listing by ID — ready to import into a Headlo store.
- import_etsy_jsonCreate a shop and import a product from Etsy Chrome extension JSON in one step.
Wedding & Events
- get_wedding_guest_listGet wedding details and full guest list with RSVP summary (attending / declined / pending). Requires list_id and token from the dashboard URL.
- update_wedding_guest_listUpdate wedding details (names, date, venue, message).
- create_wedding_guest_listCreate a free wedding RSVP page. Returns shareable URL + dashboard URL emailed to the couple.
Ask Network
- create_expert_protocolBuild a CAP (Context Accumulation Protocol) for a question on the Headlo Ask network. Provide intake questions with your expert knowledge pre-loaded — replaces the generic AI answer with a structured intake chat backed by your domain expertise.
Shipping
- get_shipping_ratesGet carrier rate options (USPS, UPS, FedEx) for a shipment before purchasing a label.
- create_shipping_labelPurchase a shipping label and return the PDF URL + tracking number.
Setup instructions and API key generation: https://www.headlo.com/mcp