# Hotspotsystem — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/hotspotsystem

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_hotspotsystem?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/hotspotsystem/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/hotspotsystem/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/hotspotsystem/skill.md
Postman collection (v2.1): https://mcp.ai/hotspotsystem/postman.json

## Tools
- hotspotsystem_customers_list(sort?: string, limit?: integer, fields?: string, offset?: integer) — 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 
- hotspotsystem_customers_list_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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
- hotspotsystem_generate_voucher_v1(format?: string, package?: string, validity?: string, location_id: string) — 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
- 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.
- 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.
- hotspotsystem_list_paid_transactions(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list paid transactions globally across all locations. Use when you need to retrieve all paid transaction records with optional pagination and sorting.
- hotspotsystem_locations_list(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list the resource owner's locations. Use when you need to retrieve locations with optional filtering, sorting, or pagination.
- hotspotsystem_misc_ping(q?: string, echo?: string) — Tool to perform health check against the HotspotSystem API. Use when verifying connectivity and availability.
- hotspotsystem_subscribers_list(sort?: string, limit?: integer, fields?: string, offset?: integer) — 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
- hotspotsystem_subscribers_list_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — Tool to list subscribers by location. Use when you need to retrieve subscribers for a specific location with optional field selection, sorting, and pagination.
- hotspotsystem_transactions_list_mac(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list MAC-based transactions. Use when you need to retrieve MAC transaction records with optional pagination and sorting.
- hotspotsystem_transactions_list_mac_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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
- hotspotsystem_transactions_list_paid_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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.
- hotspotsystem_transactions_list_social(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list social transactions. Use when you need to retrieve social transaction records with optional pagination and sorting.
- hotspotsystem_transactions_list_social_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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.
- hotspotsystem_transactions_list_voucher(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list voucher transactions globally across all locations.
- hotspotsystem_transactions_list_voucher_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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.
- hotspotsystem_vouchers_list(sort?: string, limit?: integer, fields?: string, offset?: integer) — Tool to list the resource owner's vouchers across all locations. Use when you need to retrieve vouchers with optional filtering, sorting, or pagination.
- hotspotsystem_vouchers_list_by_location(sort?: string, limit?: integer, fields?: string, offset?: integer, location_id: string) — 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 

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

## Links
Docs: https://mcp.ai/docs/mcps/hotspotsystem
Website: https://mcp.ai/mcps/hotspotsystem