hotspot logohotspot
start here

Hotspot MCP

Your creator studio, inside your AI assistant.

Hotspot ships as a Model Context Protocol server. Connect it to Claude, ChatGPT or Cursor and manage your maps, spots and earnings by chatting — no app to install.

Setup in two minutes

  1. 1. Create a key. Go to Settings and create an API key. It is shown once — copy it right away.
  2. 2. Claude Desktop, Cursor, ChatGPT. Add this to your MCP config (or as a custom connector, using the URL and the Authorization header):
    {
      "mcpServers": {
        "hotspot": {
          "url": "https://hotspot.earth/api/mcp",
          "headers": {
            "Authorization": "Bearer hs_live_…"
          }
        }
      }
    }
  3. 2b. Claude Code. One command:
    claude mcp add --transport http hotspot https://hotspot.earth/api/mcp --header "Authorization: Bearer hs_live_…"
  4. 3. Ask. Start with “what maps do I have?” — the assistant calls Hotspot for you.

Things you can ask

Click a prompt to copy it.

What the server exposes

Everything is scoped to your account. Uploads, payouts and Stripe onboarding stay in the web studio.

get_meYour profile, public URL and Stripe status
list_mapsAll your maps with spot counts and URLs
get_mapOne map with all its spots
create_mapCreate a new, unpublished map
update_mapChange title, price, currency, article link…
publish_mapPublish a map and get its public URL
unpublish_mapTake a map offline
delete_mapDelete an unpublished map (asks for confirmation)
add_spotAdd a pin by address or coordinates
add_spots_bulkAdd up to 50 spots in one go
update_spotEdit a spot's note, category, vibe, best time
delete_spotRemove a spot
reorder_spotsSet the display order
set_free_preview_spotPick the spot visitors see for free
magic_fill_spotAI-generate a note, vibe tag and best time
get_earningsTotals, per-map and per-month revenue
get_map_performanceSales analytics for one map
list_salesRecent purchases, newest first

Security

Keys are stored hashed and can be revoked at any time from Settings. Deleting a map requires an explicit confirmation from you in the conversation, and published maps must be unpublished first.