https://api.headlo.com/v1/mcp
← Setup

All 30 Tools

Paste your key above then click ▶ Run on any tool to test it.

Auth

whoami Returns the agency_id associated with the current API key.

CMS & Collections — Agency auth required

headlo_list_collections List all collections available for this agency.
headlo_list_records List records in a specific collection.
headlo_upsert_collection Create or update a collection schema.
headlo_get_collection Get the schema (field names and types) for a collection.
headlo_create_record Create a new record in a collection.
headlo_create_records_bulk Create multiple records in a collection in one call.
headlo_search_products Search the store product catalog using a natural language query.
headlo_list_approved_endpoints List approved external API endpoints configured for this agency.
http_request Make an HTTP request to an approved external endpoint.

JS Components — Agency auth required

headlo_list_components List all components available for this agency.
headlo_read_component Read the full code and metadata of a component.
headlo_update_component Update the code of a component.
headlo_upload_media_from_url Download an image from a URL and upload it to Headlo media storage. Returns media_id and alt.

Store & Commerce

create_shop Create a new online store. Returns storefront URL + dashboard URL emailed to the owner.
update_shop Update shop settings (brand name, description, custom domain, return address).
fetch_etsy_listing Fetch product data from an Etsy listing by ID — ready to import into a Headlo store.
import_etsy_json Create a shop and import a product from Etsy Chrome extension JSON in one step.

Wedding & Events

get_wedding_guest_list Get wedding details and full guest list with RSVP summary (attending / declined / pending). Requires list_id and token from the dashboard URL.
update_wedding_guest_list Update wedding details (names, date, venue, message).
create_wedding_guest_list Create a free wedding RSVP page. Returns shareable URL + dashboard URL emailed to the couple.

Ask Network

create_expert_protocol Build 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.

CAP Missions — Auth required

run_niche_mission One-call launcher for the niche intelligence protocol — finds/creates the niche and its 4-question CAP (hooks → buyer pain → offer gaps → objections), then starts the mission. Pass niche="dental" and optionally platform="facebook".
start_mission Start a CAP-driven research mission (description param) or LLM-planner mission (goal param). CAP mode auto-matches a protocol, checks byA/byQ caches, and returns the first research question.
get_mission_next_step Get the current research question for a CAP mission, including seed knowledge from the protocol and suggested tools to use.
submit_mission_finding Submit a research finding for the current step. Advances to next question. When done=true, outcome is synthesized and written to the knowledge base.
advance_mission (LLM planner) Report the result of the last tool call and get the next step.
get_mission_status (LLM planner) Get the current status and plan for a mission.

Shipping

get_shipping_rates Get carrier rate options (USPS, UPS, FedEx) for a shipment before purchasing a label.
create_shipping_label Purchase a shipping label and return the PDF URL + tracking number.