Ekstra

The MCP server Ekstra's docs said wasn't live yet. Built by @Myke_Kript

Connect any MCP-compatible AI assistant — Claude, Cursor, Windsurf — to Ekstra's real-time city intelligence API. Ask Claude "Can I park here right now?" and get a live answer.

---

What It Does

Exposes 4 tools to any AI assistant via the Model Context Protocol:

Tool	Description
ekstra_get_curb_rules	Live NYC parking rules near any lat/lng
ekstra_get_network_stats	Active devices, operators, total packets
ekstra_get_devices	Live device list with trust scores
ekstra_get_facts	Rotating Ekstra platform facts

---

Live Demo

Once deployed, visit your Vercel URL directly to confirm it's running:

GET https://your-project.vercel.app/api/mcp

Returns:

{
  "name": "ekstra-mcp-server",
  "version": "1.0.0",
  "status": "live",
  "tools": [
    "ekstra_get_curb_rules",
    "ekstra_get_network_stats",
    "ekstra_get_devices",
    "ekstra_get_facts"
  ]
}

---

Deploy to Vercel

Option A — Vercel Dashboard (No CLI)

1. Push this repo to GitHub
2. Go to vercel.com → Add New Project
3. Import your GitHub repo
4. Hit Deploy — no environment variables needed
5. Your MCP endpoint is live at: https://your-project.vercel.app/api/mcp

Option B — Vercel CLI

npm install -g vercel
vercel login
vercel --prod

---

Connect to Claude Desktop

Add this to your Claude Desktop config file:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ekstra": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-project.vercel.app/api/mcp"
      ]
    }
  }
}

Restart Claude Desktop. You'll see Ekstra tools available in Claude.

---

Connect to Cursor / Windsurf

Add to your MCP config:

{
  "mcpServers": {
    "ekstra": {
      "url": "https://your-project.vercel.app/api/mcp"
    }
  }
}

---

Example Conversations With Claude

Once connected, Claude can answer questions like:

User: Can I park on Greenwich Village right now? Claude: (calls ekstra_get_curb_rules with lat: 40.7308, lng: -73.9973)

There are 66 active restrictions near Greenwich Village right now. The nearest legal spot opens in 2 hours 31 minutes.

---

User: How big is the Ekstra network? Claude: (calls ekstra_get_network_stats)

The Ekstra network currently has 8,363 active devices across 3 operators, having processed 9,508 total packets.

---

User: Show me active cameras on the Ekstra network Claude: (calls ekstra_get_devices with device_type: camera)

Found 12 active cameras. Here are the top results...

---

Protocol Details

Detail	Value
Protocol	MCP JSON-RPC 2.0 over HTTP POST
Auth	None required
Ekstra endpoints used	Public (no API key needed)
Max response time	30 seconds (Vercel limit)
CORS	Open (*)

---

File Structure

ekstra-mcp-server/
├── api/
│   └── mcp.js       ← Vercel serverless function (MCP handler)
├── package.json
├── vercel.json      ← Vercel config + CORS headers
└── README.md        ← This file

---

How It Works

AI Assistant (Claude / Cursor)
        │
        │  POST /api/mcp
        │  { method: "tools/call", params: { name: "ekstra_get_curb_rules", ... } }
        ▼
Vercel Serverless Function (api/mcp.js)
        │
        │  GET https://ekstra.ai/api/v1/curb-rules/near?lat=...
        ▼
Ekstra Public API
        │
        │  { rules: [...] }
        ▼
Formatted plain-text response
        │
        ▼
AI Assistant renders answer to user

No database. No auth. No config. Pure API proxy with MCP protocol on top.

---

Extending This

Add more Ekstra endpoints

When Ekstra ships new endpoints (spaces, director AI, observer), add them as new tools in api/mcp.js following the same pattern.

Add the MCP server to Option 1 dashboard

The city intelligence dashboard and the MCP server share the same Ekstra API calls. They can be linked — the dashboard becomes a visual layer on top of the same data the MCP server exposes.

Add authentication

When Ekstra's authenticated endpoints ship (device management, private data), add an EKSTRA_API_KEY environment variable in Vercel and pass it as a Bearer token.

---

Built For

• Ekstra Build Contest — 5 SOL prize
• Submission by @Myke_Kript

Ekstra's own docs state: "MCP server is a known follow-up — not live." This is that server.

---

License

Apache-2.0 — Same as the Ekstra SDK ecosystem. Free to fork and submit as a PR to build-with-ekstra.