# Hotspotsystem — how to use (mcp.ai)

Connect your Hotspotsystem account and use 19 tools for internet of things straight from your AI agent. Connect with your own API key. HotspotSystem provides public Wi-Fi hotspot management and billing services for businesses.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_hotspotsystem?ms=1787295840000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `hotspotsystem_customers_list`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/hotspotsystem`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/hotspotsystem/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/hotspotsystem/customers/list` — Lists all customers in the HotspotSystem account with optional filtering. Use this tool to: - Retrieve all customers with their details (name, email, contact info, registration date, etc.) - Paginate 
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/customers/list/by/location` — Lists all customers associated with a specific HotspotSystem location. Use this tool to: - Retrieve customer details (name, email, contact info, registration date) for a specific location - Paginate t
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/generate/voucher/v1` — Generates an access voucher code on-demand for a specific location. This action creates a single-use voucher that can be used for hotspot access. The voucher is generated against available voucher cre
  - body: { format?: string, package?: string, validity?: string, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/get/locations/options` — Tool to get simplified list of locations as dropdown options. Returns only id/name pairs for each location. Use when you need location options for selection menus or dropdowns.
- `POST https://api.mcp.ai/api/hotspotsystem/get/me` — Tool to verify the resource owner's credentials and retrieve authenticated user information. Use when you need to confirm authentication status or get the current user's ID and operator name.
- `POST https://api.mcp.ai/api/hotspotsystem/list/paid/transactions` — Tool to list paid transactions globally across all locations. Use when you need to retrieve all paid transaction records with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/locations/list` — Tool to list the resource owner's locations. Use when you need to retrieve locations with optional filtering, sorting, or pagination.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/misc/ping` — Tool to perform health check against the HotspotSystem API. Use when verifying connectivity and availability.
  - body: { q?: string, echo?: string }
- `POST https://api.mcp.ai/api/hotspotsystem/subscribers/list` — List newsletter subscribers across all locations with optional filtering, sorting, and pagination. Returns subscriber information including contact details (name, email, phone, address) and social net
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/subscribers/list/by/location` — Tool to list subscribers by location. Use when you need to retrieve subscribers for a specific location with optional field selection, sorting, and pagination.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/mac` — Tool to list MAC-based transactions. Use when you need to retrieve MAC transaction records with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/mac/by/location` — Lists MAC address authentication transactions for a specific location. MAC (Media Access Control) transactions track network access granted based on device MAC addresses. Use this action when you need
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/paid/by/location` — Tool to list paid transactions by location. Use when you need to retrieve paid transaction records for a specific location with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/social` — Tool to list social transactions. Use when you need to retrieve social transaction records with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/social/by/location` — Tool to list social transactions by location. Use when you need to retrieve social transaction records for a specific location with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/voucher` — Tool to list voucher transactions globally across all locations.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/transactions/list/voucher/by/location` — Tool to list voucher transactions by location. Use when you need to retrieve voucher transaction records for a specific location with optional pagination and sorting.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }
- `POST https://api.mcp.ai/api/hotspotsystem/vouchers/list` — Tool to list the resource owner's vouchers across all locations. Use when you need to retrieve vouchers with optional filtering, sorting, or pagination.
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer }
- `POST https://api.mcp.ai/api/hotspotsystem/vouchers/list/by/location` — Retrieves all vouchers associated with a specific location in the HotspotSystem. Use this action to: - List all vouchers available at a particular location - Filter voucher results by specific fields 
  - body: { sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string }

## Example prompts
- "What can I do in Hotspotsystem?"
- "Show me a summary of my Hotspotsystem account"

## More
- Page: https://mcp.ai/hotspotsystem
- Agent spec (llms.txt): https://mcp.ai/hotspotsystem/llms.txt
- Postman collection: https://mcp.ai/hotspotsystem/postman.json