# Beaconstac — MCP server on mcp.ai
> Connect your Beaconstac account and use 21 tools for marketing straight from your AI agent. Connect with your own API key. Beaconstac provides a platform for creating and managing QR codes and beacons, enabling businesses to engage customers through proximity marketing and track analytics.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_beaconstac?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/beaconstac/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/beaconstac/<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/beaconstac/skill.md
Postman collection (v2.1): https://mcp.ai/beaconstac/postman.json

## Tools
- beaconstac_create_place(name: string, address: string, latitude: string, longitude: string, organization: integer) — Tool to create a new place for location-based assets. Use when you need to register a new physical place under an organization.
- beaconstac_create_qr_template(meta?: object, name: string, margin?: integer, default?: boolean, dotScale?: number, colorDark?: string, frameText?: string, logoImage?: string, logoScale?: number, colorLight?: string, frameColor?: string, frameStyle?: string, dataPattern?: string, eyeBallColor?: string, eyeBallShape?: string, gradientType?: string, organization: integer, eyeFrameColor?: string, eyeFrameShape?: string, frameTextColor?: string, backgroundColor?: string, backgroundImage?: string) — Creates a new QR Code template with customizable design attributes. QR Code templates allow you to define reusable design presets for QR codes in your organization. You can customize colors, patterns,
- beaconstac_create_tag(name: string, organization: integer) — Tool to create a new tag for organizing QR Codes and other objects. Use when you need to categorize QR Codes under a specific organization.
- beaconstac_create_user(email?: string, password?: string, username: string, last_name?: string, first_name?: string, organization: integer, billing_email?: string, customer_plan: string, profile_picture?: string) — Tool to create a new User. Use when onboarding a new user under your organization (Reseller plan and above).
- beaconstac_delete_qr_code(id: integer) — Tool to delete a QR Code by its ID. Use when you need to remove an existing QR Code after validation.
- beaconstac_delete_qr_template(id: integer) — Tool to delete a QR Code template by its ID. Use when you need to permanently remove a QR Code template that is no longer needed.
- beaconstac_delete_tag(tag_id: integer) — Tool to delete a tag by its ID. Use when you need to remove an existing Tag after validation.
- beaconstac_list_bulk_qr_codes(page?: integer, search?: string, ordering?: string, page_size?: integer, qr_data_type?: integer, name__icontains?: string) — Tool to list Bulk QR Code collections. Use when you need to filter, search, or order your bulk QR Code collections.
- beaconstac_list_organizations(page?: integer, page_size?: integer) — List all organizations accessible to the authenticated account. Use this tool when you need to: - Get a list of all organizations the user has access to - Retrieve organization details including IDs, 
- beaconstac_list_places(name?: string, page?: integer, search?: string, ordering?: string, page_size?: integer, name__icontains?: string) — Tool to list your Places. Use when you need to browse or search your account's Places with filtering and ordering.
- beaconstac_list_qr_templates(page?: integer, page_size?: integer, organization: integer, name__icontains?: string) — Tool to list all QR code templates in your account. Use when you need to filter and paginate templates.
- beaconstac_list_tags(page?: integer, ordering?: string, page_size?: integer, name__icontains?: string) — Tool to list all tags with optional filtering and pagination. Use when you need to browse or search tags in your account.
- beaconstac_list_users(page?: integer, search?: string, ordering?: string, page_size?: integer, email__exact?: string, organization?: integer, customer_plan?: string, date_joined__gt?: string, date_joined__lt?: string, username__exact?: string, date_joined__gte?: string, date_joined__lte?: string, email__icontains?: string, last_name__exact?: string, first_name__exact?: string, subscription_state?: string, username__icontains?: string, last_name__icontains?: string, first_name__icontains?: string) — Tool to list all users with optional filtering, searching, ordering, and pagination. Use when you need to retrieve user records across your organization.
- beaconstac_period_overview(organization: integer, product_type: string, to_timestamp: integer, from_timestamp: integer) — Tool to get period overview analytics for products including counts, impressions, and conversion percentage. Use after specifying the product_type and time interval.
- beaconstac_product_overview(organization: integer, product_type: string, to_timestamp: integer, from_timestamp: integer) — Tool to get analytics overview for a specified product type over a given time interval. Use after specifying the product type and time range to obtain summary metrics.
- beaconstac_retrieve_qr_code(id: integer) — Retrieve detailed information about a specific QR Code by its ID. Returns QR code properties including name, type (static/dynamic), short URL, encoded data, design attributes, scan count, organization
- beaconstac_retrieve_user(id: integer) — Tool to retrieve the details of an existing User by ID. Use when you need to fetch a user's profile after confirming its existence.
- beaconstac_update_place(name: string, address?: string, latitude?: number, place_id: integer, longitude?: number, organization: integer, business_color?: string, business_icon_url?: string, business_cover_url?: string) — Tool to update the specified Place by ID. Use after retrieving the Place to modify its details, such as name, address, or coordinates.
- beaconstac_update_qr_code(meta?: object, name?: string, tags?: integer[], place?: integer, qr_type?: integer, campaign?: object, qrcode_id: integer, attributes?: object, fields_data?: object, organization?: integer) — Update an existing QR Code by its ID. Modify QR Code properties like name, design attributes, tags, and content. Returns the complete updated QR Code object. Important: When updating qr_type, you must
- beaconstac_update_tag(name?: string, color?: string, tag_id: integer) — Tool to update an existing tag by its ID. Use when you need to modify a tag's name or color after confirming its ID via list_tags.
- beaconstac_update_user(user_id: integer, last_name?: string, first_name?: string, organization?: integer, profile_picture?: string) — Tool to update an existing User. Use when you need to modify profile details or organization of a User by their ID.

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

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