Developer Hub

WiFi networks generate more behavioral data than most SaaS products. Now you can query it.

Guest Networks MCP is a production MCP server backed by 14 years of guest WiFi infrastructure. 75M+ connection events. Real-time occupancy. Standard MCP protocol — works with any compliant AI client.

Get API Key →Live Playground ↗
Quickstart

Zero to first query in 5 minutes

1
Install
npm install @guestnetworks/mcp-server
2
Authenticate
export GN_API_KEY="gn_live_your_key_here"
3
Query
const venues = await gn.callTool("get_venue_list", {});
import { GuestNetworksMCPClient } from "@guestnetworks/mcp-server";

const gn = new GuestNetworksMCPClient({
  apiKey: process.env.GN_API_KEY!,
});

// Get all venues in your account
const { data: venues } = await gn.callTool("get_venue_list", {});

// Get real-time occupancy for first venue
const { data: occ } = await gn.callTool("get_current_occupancy", {
  venue_id: venues[0].venue_id,
});

console.log(`${occ.occupancy.current_count}/${occ.occupancy.capacity} occupied`);
// → 47/120 occupied

View full API reference → · Try in the live playground →

Example Queries

What your AI agent can ask

Occupancy & foot traffic
"How many people are currently in the main dining area at Venue 12?"
"What was peak occupancy at each of my venues last Saturday between 12pm–3pm?"
Connection analytics
"How many unique guests connected at Location 7 yesterday vs the same day last week?"
"Which venues have had a >20% drop in daily connections over the past 14 days?"
Dwell time & loyalty
"What's the average dwell time at venues in the hospitality vertical compared to retail?"
"Which locations have the highest proportion of guests who have connected more than 5 times?"
Portfolio-level
"Rank all venues by foot traffic growth rate over the past 90 days. Show top 5 and bottom 5."
"Generate a Q1 2026 performance summary across all venues in the Harbour Hotels account."
How It Works

Connect once. Query everything.

🔌
Step 1
Connect
Add the MCP server to your agent config. stdio or HTTP/SSE transport. Works with Claude Desktop, custom agents, LangChain.
🔑
Step 2
Authenticate
One API key scopes access to your venue portfolio. No OAuth dance, no token refresh loops.
🔍
Step 3
Query
Your agent auto-discovers 15 tools via MCP tool-listing. Self-describing — no schema docs to parse.
🚀
Step 4
Build
Answer questions, trigger alerts, generate reports, feed downstream systems. Your agent owns the reasoning.
Claude Desktop Integration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json. Restart Claude Desktop. Start asking questions.

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "guestnetworks": {
      "command": "npx",
      "args": ["@guestnetworks/mcp-server", "--transport", "stdio"],
      "env": {
        "GN_API_KEY": "gn_live_your_key_here"
      }
    }
  }
}
Example Agent

Occupancy anomaly detector

Polls all venues in parallel, flags anything over 90% capacity. Deploy as a cron job or reactive agent.

async function checkOccupancyAnomalies(venueIds: string[]) {
  const results = await Promise.all(
    venueIds.map((id) =>
      gn.callTool("get_current_occupancy", { venue_id: id })
    )
  );

  return results
    .filter((r) => r.data.occupancy.current_count / r.data.occupancy.capacity > 0.9)
    .map((r) => ({
      venue_id: r.data.venue_id,
      occupancy_pct: Math.round(
        (r.data.occupancy.current_count / r.data.occupancy.capacity) * 100
      ),
      alert: "NEAR_CAPACITY",
    }));
}
Use Cases

What developers are building

💬
AI Chatbot for Venue Operators

Natural language interface so venue managers can query their own data. "How many new customers did I get last Tuesday?" — answered in real time.

get_connection_statsget_loyalty_metricsget_dwell_time_analytics
🏢
Franchise Analytics Agent

Portfolio-level intelligence for hotel groups, restaurant chains, retail franchises. One agent, one data connection, full portfolio visibility.

get_venue_listget_connection_statsget_occupancy_timeseries
🚨
Real-Time Occupancy Alerts

Alerting agent that polls occupancy every 60 seconds and notifies via Slack, SMS, or webhook when thresholds are crossed.

get_current_occupancyget_occupancy_timeseries
📊
White-Label Reporting Tool

MSPs managing dozens of accounts can deliver monthly performance reports automatically — real data, structured narrative, branded delivery.

get_connection_statsget_loyalty_metricsget_environment_metrics
Early Access Pricing

Start free, scale as you grow

Free
Free
1 venue · 10K events/mo
REST API
3 MCP tools
90-day raw event retention
Community support
Get API Key
Most Popular
Team
$99/mo
5 venues · 100K events/mo
All 15 MCP tools
All 36 integrations
90-day raw event retention
Email support 48h SLA
Start Free Trial
Business
$499/mo
Unlimited venues · 1M events/mo
AI Agents (Claude, GPT, Gemini)
Real-time WebSocket
90-day raw events + long-term rollups
Priority support 4h SLA
Start Free Trial

All paid plans include a 14-day free trial · No credit card required to start

FAQ

Common questions

Q: What version of MCP does this server implement?
MCP 1.0 (current stable spec). All transport mechanisms supported: stdio, HTTP/SSE. 1.1 support shipping within 30 days of stable release.
Q: What AI clients work with this?
Any MCP-compatible client. Verified: Claude Desktop, custom TypeScript/Python agents, LangChain MCP adapters, direct HTTP clients. OpenAI-based agents use the REST API path.
Q: Is the data real-time or batched?
Both. get_current_occupancy is real-time (sub-5s latency camera, sub-30s WiFi-inferred). Analytics tools query TimescaleDB updated continuously — no batch jobs, no stale exports.
Q: How does authentication work?
API keys per organization, scoped to venues in your account. Long-lived by default, rotatable anytime from the dashboard. IP allowlisting on Builder and Production plans.
Q: Can I scope a key to specific venues?
Yes — create keys scoped to venue groups or individual venues. Useful for multi-tenant products where end clients should only see their own data.

You're one API key away from making physical spaces queryable.

Takes 2 minutes. Developer tier is free forever.

Get API Key →Browse API Reference ↗