MCP + REST + Webhooks + WebSocket

Build agents. Build dashboards. Build whatever your CRM is missing.

MCP tools. 6 REST APIs. Webhooks for every event. SDKs in TypeScript, Python, Go, and Rust. Open source MCP server. Your AI agent talks to the network the same way Compass does.

Get an API key MCP server docs

Six surfaces

MCP for agents. REST for everything else.

The MCP server is the primary surface for AI agents — natural-language tooling against the network. The five REST APIs cover the rest of the surface (auth, customers, nodes, network config, captive portals). Same auth, same data model.

Open Source on GitHub
MCP Server

MCP Server

Open Source

MCP tool surface via Model Context Protocol. Dual transport: stdio + HTTP. The primary surface for AI agents and the LLM gateway in Compass.

mcp.airfy.ai
Users API

Users API

GA

Authentication, MFA (4-step flow: startLogin, pickMethod, performMethod, finish), user management. Key + Email auth.

users.api.airzen.io
Customers API

Customers API

GA

Customer data, billing, locations, partner tokens. Bearer token auth.

customers.api.airzen.io
Nodes API

Nodes API

GA

Access point management, firmware, status, connection metrics. Device lifecycle.

nodes.api.airzen.io
Netconf API

Netconf API

GA

Network configuration, SSIDs, radio configs, VLANs. The network brain.

netconf.api.airzen.io
Portals API

Portals API

GA

Captive portal management, guest WiFi, marketing automation, vouchers.

portals.api.airzen.io

Code, five ways

From your AI agent to your CI script.

// In your AI agent or chat app, register the Airfy MCP server.
// MCP tool surface become available in natural language.

{
  "mcpServers": {
    "airfy": {
      "command": "npx",
      "args": ["-y", "@airfy/mcp-server"],
      "env": { "AIRFY_API_KEY": "..." }
    }
  }
}

// Then in chat:
// "Why is the WiFi slow at 1410 W. Mockingbird?"
// "Block YouTube on Leon's iPad after 8pm."
// "Show me devices that joined any office in the last hour."

Outbound events

Webhooks for the events your team actually needs.

HMAC-signed POST per event. Configurable per tenant. Retries with exponential backoff. Use them to fire your own alerting, ticketing, billing, or CRM workflow.

client.connected

A device joined an SSID. Includes MAC, identity, signal, AP, location.

client.disconnected

A device left or was kicked. Includes session duration, bytes, reason.

node.status_changed

AP went online, offline, or degraded. Includes diagnostics summary.

firmware.updated

Signed firmware bundle installed. Includes version, channel, success/failure.

anomaly.detected

Compass agent detected something unusual at a site. Includes severity and proposed fix.

ticket.opened

Auto-resolve gave up and escalated to a human queue. Includes context.

sla.breached

Customer SLA on uptime, latency, or throughput crossed the threshold.

policy.violation

A device tried to do something policy didn't allow. Includes the device and the rule.

SDKs for the language your team already uses.

JavaScript / TypeScript@airfy/sdk
GA
Pythonairfy
GA
Gogit.airzen.io/cloud/cloud_api
Internal
Rustairfy-core
Internal
MCP Server (Rust)mcp-server-airfy-rs
Open Source

Specs, code, status

Everything you'd open at 11pm before signing the integration ticket.

OpenAPI 3.1 spec

Full REST surface as a single openapi.yaml. Generate clients for any language.

openapi.airfy.ai

Postman collection

Pre-built collection for every endpoint. Import, set your key, start hitting endpoints.

Postman

MCP server source

Rust implementation of the Airfy MCP server. MCP tool surface, dual transport. Self-hostable.

GitHub

Status page

Real-time uptime for every Airfy region (FRA, AUS) and the MCP gateway. Subscribe to incident alerts.

status.airfy.com

Developer FAQ.

Your code. Our network. Plain language.

Free tier. MCP tools. REST + MQTT + webhooks + WebSocket. Open source MCP server. Get your key, ship the integration before lunch.

Get an API key (free) MCP server docs