Zone ASAP
Download
MCP Integration
Private Beta

Your AI
meets the zone.

Zone ASAP implements the Model Context Protocol ↗ so Claude, Cursor, and compatible AI clients can discover places, query Aura data, and take real-world actions on your behalf — from a single chat message.

Request API AccessMCP Spec
7 Tools
available
HTTP Transport
JSON-RPC 2.0
Bearer Token
auth
Proximity Verified
check-ins
OverviewQuick StartConfigurationToolsAuthRate Limits

01 — What is MCP?

The AI tool layer for real places.

Model Context Protocol

MCP is an open standard that lets AI assistants connect to external systems — databases, APIs, apps — through a uniform interface. Think of it as a USB-C port for AI tool use.

modelcontextprotocol.io

Zone ASAP MCP Server

Our MCP server exposes 7 tools covering place discovery, Aura queries, and check-ins. Public tools need no auth. User tools use an API key. Check-ins are proximity-verified server-side.

PublicAuthProximity
Example — Claude with Zone ASAP MCP
U
Find me a quiet café near Koramangala to work from today.
AI
Let me check Zone ASAP for cafes near Koramangala... [calling discover_nearby_places · lat 12.9352, lng 77.6245, category cafes] Found 4 options within 2 km: 1. The Brew Collective — 0.4 km · ★4.7 · #quiet #wifi #coworking Mayor: @priya_codes · 38 check-ins this week 2. Third Wave Coffee — 0.9 km · ★4.5 · #specialty #fast-wifi 3. Araku Origins — 1.2 km · ★4.8 · #pour-over #no-laptops (heads up) 4. Dyu Art Café — 1.8 km · ★4.6 · #artsy #quiet #garden The Brew Collective is your best bet — closest, highest Aura this week, and coworking is literally in its tags.

02 — Setup

Connected in three steps.

01

Get an API key

The MCP server is in private beta. Email us to request access — we'll send you an API key within 24 hours.

Request Access
02

Add the server to your AI client

Copy the config for your client below, paste your API key, and restart.

See configs
03

Talk to your AI

Ask your AI to "find places near me" or "show my Aura stats" — it will call Zone ASAP's tools automatically.

03 — Configuration

Pick your client.

~/Library/Application Support/Claude/claude_desktop_config.json
json
{
  "mcpServers": {
    "zone-asap": {
      "type": "http",
      "url": "https://mcp.zoneasap.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with the key from your confirmation email. The server URL never changes — https://mcp.zoneasap.com.

04 — Tools

7 tools. Real actions.

PublicNo API key needed·AuthRequires API key·ProximityAPI key + within 100 m of place

05 — Authentication

Three tiers. Clear rules.

Public

Public Tools

discover_nearby_places, get_place_details, search_places, and get_leaderboard require no authentication. Anyone can query place data.

Auth

User Tools

Tools that access personal data (your Aura, your crew locations) require a valid API key in the Authorization header.

Proximity

Proximity Verified

Check-in requires an API key AND that the submitted coordinates are within 100 m of the place. Verified server-side — no client-side trust.

http
GET /mcp HTTP/1.1
Host: mcp.zoneasap.com
Content-Type: application/json
Authorization: Bearer za_live_xxxxxxxxxxxxxxxxxxxx

06 — Rate Limits

Fair use during beta.

Tier
Requests / day
Notes
Anonymous
100
Public tools only · no key required
Developer
10,000
All tools · free during beta
Team (coming)
100,000
All tools + webhooks · paid post-beta

Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) are returned on every response. Exceeding the limit returns HTTP 429 with a retry_after field.

07 — Inspiration

What can you build?

☕

"Where should I work from today?"

Your AI discovers the highest-aura cafes with wifi near your current location and picks the one your crew has been to most.

👑

"Who's the mayor of the nearest park?"

Your AI fetches place details for the closest park and surfaces the mayor's username, check-in count, and the AI verdict.

⚡

"What's my Aura streak?"

Your AI calls get_my_aura and tells you your points, streak, and which zones you're mayor of — no app needed.

📍

"Check me in here"

With your permission, your AI calls check_in with your current GPS coordinates. The server verifies proximity and awards Aura instantly.

👥

"Where is my crew right now?"

Your AI fetches crew locations and summarises — "Sahil is at The Brew House, Zara visited 3 spots today."

🗺️

Morning zone briefing

A scheduled prompt that runs each morning: who's leading the leaderboard this week, which spots are trending, what your streak is at.

Ready to connect?

The Zone ASAP MCP server is in private beta. Email us with what you want to build and we'll get you an API key within 24 hours.

Request API AccessTry the App Preview