Headlo MCP Server
Headlo MCP Server
active Production-safe Score 94/100 http no auth
At a glance
| Endpoint | https://api.headlo.com/v1/mcp |
|---|---|
| Source | https://github.com/headlohq/headlo-mcp |
| Transport | http |
| Tools | 76 |
| Auth | none |
| First seen | 2026-06-16 00:45:43 |
| Last checked | 2026-11-17 21:55:47 |
Observed reliability
| 7-day uptime | 100% |
|---|---|
| 24-hour uptime | 100% |
| Handshake success | 100% |
| Latency p50 / p95 | 437 / 721 ms |
| Last successful check | 2026-11-17 21:55:47 |
Measured by Arclan's validator via repeated live MCP handshakes. How this is computed →
Tools (76)
whoami— Returns the agency_id associated with the current API key. Useful for confirming which account is authenticated.headlo_list_collections— List all collections available for this agency.headlo_list_records— List records in a specific collection. workspace_id is optional — if omitted, all workspaces are searched.headlo_get_record— Get a single record by ID with all field values. Supports partial UUID matches (e.g., first 8 characters).headlo_upsert_collection— Create or update a collection schema. If the collection does not exist it is created. If it exists the schema is updated (fields cannot be rheadlo_get_collection— Get the schema (field names and types) for a collection. Call this before creating records to know which fields to populate.headlo_create_record— Create a new record in a collection. workspace_id is optional — if omitted it is looked up automatically.headlo_create_records_bulk— Create multiple records in a collection in one call. Returns a JSON array of { id, name } for each created record — use the id values to setheadlo_search_products— Search the store product catalog using a natural language query. Returns matching products with name, handle, price, and description snippetheadlo_ask_knowledge— Ask a natural-language question of the agency knowledge graph. The server retrieves attested records via cosine similarity, then an LLM syntheadlo_search_knowledge— Search the agency knowledge graph (platform.knowledge) using natural-language semantic search. Retrieves voice notes, expert commentary, phoheadlo_list_approved_endpoints— List approved external API endpoints configured for this agency.http_request— Make an HTTP request to an approved external endpoint.graph_create_node— Create a place, street, waypoint, or junction node in the physical world graph. Stores GPS coordinates, a rich human-perspective descriptiongraph_get_node— Get a graph node by ID including its outbound and inbound edges.graph_update_node— Update a graph node. Any field can be updated; updating body triggers re-embedding. Use heading_deg to store the compass heading at NFC tapgraph_list_nodes— List graph nodes. Optionally filter by type and/or proximity to a GPS location.graph_nearby— Find graph nodes near a GPS location, sorted by distance. Useful for discovering what nodes exist around a capture point.graph_create_edge— Create a directed traversal edge from one graph node to another. The text field is the human-perspective description of how to get from A tograph_create_tip— Attach an insider tip to a graph node. Tips are knowledge locals have that visitors don't — who to ask, hidden spots, timing hacks, shortcutgraph_list_tips— List all tips attached to a graph node.street_capture_expert— Conversational street or place capture assistant. Asks one question at a time, validates answers, and builds a complete node record. Pass sestreet_info_view— Look up a street or place by name and city. Returns the captured record info (description, location, notes, view link). Read-only — no savinstreet_capture_edit_expert— Conversational editor for an existing street or place node. Pass node_id (12-char ID or slug) and an empty message to load the current recorstore_capture_expert— Conversational store capture assistant. Collects store identity (name, address, chain, type, city, state) and a rich description for search.inventory_capture_expert— Conversational store inventory capture. Guides you through selecting a store and section, then capturing product prices one at a time. Say "inventory_list— List store inventory records. Filter by store_id, section_id, or UPC. Returns recent price scans with age and staleness info.inventory_compare— Compare prices for a UPC across all stores. Returns a table sorted by unit_price ascending with staleness flags. Use this to answer "is thisinventory_history— Get full price history for a UPC at one or all stores. Returns chronological price series with all-time low/high.cap_capture_expert— Run an existing CAP (Contextual Answer Protocol) as a live intake session. Pass cap_id and an empty message to load the CAP and start the ficap_edit_expert— Conversationally edit an existing CAP — add questions (with GPT-generated knowledge probes), remove questions, or edit multiple-choice answeheadlo_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. Always preserve the function signature: function Component({ records, options, fetch, token, navigate, onCliheadlo_upload_media_from_url— Download an image from a URL and upload it to Headlo media storage. Returns JSON with media_id and alt — use this as the value of an image fcreate_shop— Create a new online store on Headlo. Returns a storefront URL and a private dashboard URL emailed to the owner. No account needed — owner maupdate_shop— Update settings on an existing Headlo shop. Handle cannot be changed — it is the permanent store ID. Requires handle and token from the dashget_wedding_guest_list— Get the details and full guest list for an existing wedding. Returns wedding info (name, date, venue), all guests with their RSVP status, anupdate_wedding_guest_list— Update an existing wedding guest list. Requires the list_id (from the dashboard URL) and the dashboard token. All fields are optional — onlycreate_expert_protocol— Create a CAP (Context Accumulation Protocol) for a question on the Headlo Ask network. Before writing any knowledge probes, always do a webcreate_bounties_batch— Seed the Ask Network question pool from a block of text. Paste a list of questions, problem descriptions, or user scenarios — the tool extracreate_wedding_guest_list— Create a free wedding guest list and RSVP page on Headlo. Returns a shareable RSVP URL and a private dashboard URL emailed to the couple. Nofetch_etsy_listing— Fetch product data from an Etsy listing by ID. Returns JSON-LD structured data, extracted fields (name, price, images, description), and theimport_etsy_json— Create a new Headlo shop and import a product from Chrome extension Etsy JSON in one step. Pass the full JSON payload from the Etsy Chrome eget_shipping_rates— Get carrier rate options (USPS, UPS, FedEx) for a shipment. Call this before create_shipping_label to let the user choose a carrier and servcreate_shipping_label— Purchase a shipping label and return the PDF URL and tracking number. Pass rate_id from get_shipping_rates to use a specific carrier/serviceniche_list— List all marketing niches you have created in the Niche Knowledge Builder. Returns niche_id, label, ICP type, and vertical for each.niche_create— Create a new marketing niche in the Niche Knowledge Builder. After creating it, load hooks, pain phrases, offers, objections, and flows withniche_get— Get a full niche with all loaded patterns — hooks (with performance tier), pain phrases, offer map, objections, and flow templates.niche_add_hook— Add a single hook to a niche. Performance tier is auto-assigned from run_duration_days × competitor_count (high / medium / low / unknown). Uniche_import_hooks— Bulk import up to 200 hooks into a niche. Each hook must have hook_text; all other fields are optional. Performance tier is auto-derived perniche_add_pain_phrase— Add a verbatim buyer pain phrase to a niche. Phrases should come from real sources: Reddit, YouTube comments, sales call recordings, reviewsniche_add_offer— Add an offer pattern to a niche offer map. Mark gap_opportunity=true when this offer type is missing from the market.niche_add_objection— Add a buyer objection and its proven reframe to a niche. Confidence marks how validated the reframe is: proven (closed deals), tested (obserniche_add_flow— Add a multi-step appointment or follow-up flow template to a niche. Each step has a channel, message template, delay, and goal.run_niche_mission— Launch a niche intelligence mission — builds the hook library, buyer pain vocabulary, offer gap map, and objection reframe map for a niche iissue_virtual_tag— Issue a Virtual Attest Tag — a one-time attestation token tied to a specific outcome goal. An agent taps it to confirm the outcome without rtap_virtual_tag— Tap a Virtual Attest Tag to confirm an outcome. Fires side-effects: upgrades knowledge outcome_status, marks bounty resolved, or confirms taget_tag_taps— List all taps on a Virtual Attest Tag.signer_get_dashboard— Get the Headlo Verified Signer account info and summary stats: brand name, domain, plan, code prefix, NFC server URL, and counts of total/wr
Validation history
| Checked | Reachable | Handshake | Latency | Score | State |
|---|---|---|---|---|---|
| 2026-11-17 21:55:47 | ✓ | ✓ | 704 ms | 90 | active |
| 2026-11-17 21:40:32 | ✓ | ✓ | 497 ms | 90 | active |
| 2026-11-17 21:25:18 | ✓ | ✓ | 844 ms | 90 | active |
| 2026-11-17 21:10:09 | ✓ | ✓ | 452 ms | 90 | active |
| 2026-11-17 20:55:05 | ✓ | ✓ | 394 ms | 90 | active |
| 2026-11-17 20:40:00 | ✓ | ✓ | 707 ms | 90 | active |
| 2026-11-17 20:24:58 | ✓ | ✓ | 730 ms | 90 | active |
| 2026-11-17 20:09:45 | ✓ | ✓ | 371 ms | 90 | active |
| 2026-11-17 19:53:55 | ✓ | ✓ | 639 ms | 90 | active |
| 2026-11-17 19:38:53 | ✓ | ✓ | 753 ms | 90 | active |
| 2026-11-17 19:23:36 | ✓ | ✓ | 424 ms | 90 | active |
| 2026-11-17 19:08:29 | ✓ | ✓ | 715 ms | 90 | active |
| 2026-11-17 18:53:11 | ✓ | ✓ | 366 ms | 90 | active |
| 2026-11-17 18:38:09 | ✓ | ✓ | 851 ms | 90 | active |
| 2026-11-17 18:23:05 | ✓ | ✓ | 473 ms | 90 | active |
Query this programmatically
Agents can pull this record live over the MCP protocol or REST:
get_server("https://api.headlo.com/v1/mcp") # via the Arclan MCP endpoint https://arclan.ai/mcp
GET https://arclan.ai/api/registry/api-headlo-com-v1-mcp # JSON