{
  "info": {
    "name": "Beaconstac — mcp.ai",
    "description": "REST API for the Beaconstac MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/beaconstac",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "beaconstac_create_place",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/place",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "place"
          ]
        },
        "description": "Tool to create a new place for location-based assets. Use when you need to register a new physical place under an organization.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"address\": \"\",\n  \"latitude\": \"\",\n  \"longitude\": \"\",\n  \"organization\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_create_qr_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/qr/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "qr",
            "template"
          ]
        },
        "description": "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,",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"meta\": {},\n  \"name\": \"\",\n  \"margin\": 0,\n  \"default\": false,\n  \"dotScale\": 0,\n  \"colorDark\": \"\",\n  \"frameText\": \"\",\n  \"logoImage\": \"\",\n  \"logoScale\": 0,\n  \"colorLight\": \"\",\n  \"frameColor\": \"\",\n  \"frameStyle\": \"\",\n  \"dataPattern\": \"\",\n  \"eyeBallColor\": \"\",\n  \"eyeBallShape\": \"\",\n  \"gradientType\": \"\",\n  \"organization\": 0,\n  \"eyeFrameColor\": \"\",\n  \"eyeFrameShape\": \"\",\n  \"frameTextColor\": \"\",\n  \"backgroundColor\": \"\",\n  \"backgroundImage\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_create_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "tag"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"organization\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_create_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "user"
          ]
        },
        "description": "Tool to create a new User. Use when onboarding a new user under your organization (Reseller plan and above).",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"password\": \"\",\n  \"username\": \"\",\n  \"last_name\": \"\",\n  \"first_name\": \"\",\n  \"organization\": 0,\n  \"billing_email\": \"\",\n  \"customer_plan\": \"\",\n  \"profile_picture\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_delete_qr_code",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/qr/code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "qr",
            "code"
          ]
        },
        "description": "Tool to delete a QR Code by its ID. Use when you need to remove an existing QR Code after validation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_delete_qr_template",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/qr/template",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "qr",
            "template"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_delete_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "tag"
          ]
        },
        "description": "Tool to delete a tag by its ID. Use when you need to remove an existing Tag after validation.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"tag_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_bulk_qr_codes",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/bulk/qr/codes",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "bulk",
            "qr",
            "codes"
          ]
        },
        "description": "Tool to list Bulk QR Code collections. Use when you need to filter, search, or order your bulk QR Code collections.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"search\": \"\",\n  \"ordering\": \"\",\n  \"page_size\": 0,\n  \"qr_data_type\": 0,\n  \"name__icontains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_organizations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/organizations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "organizations"
          ]
        },
        "description": "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, ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_places",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/places",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "places"
          ]
        },
        "description": "Tool to list your Places. Use when you need to browse or search your account's Places with filtering and ordering.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"page\": 0,\n  \"search\": \"\",\n  \"ordering\": \"\",\n  \"page_size\": 0,\n  \"name__icontains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_qr_templates",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/qr/templates",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "qr",
            "templates"
          ]
        },
        "description": "Tool to list all QR code templates in your account. Use when you need to filter and paginate templates.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"page_size\": 0,\n  \"organization\": 0,\n  \"name__icontains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_tags",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/tags",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "tags"
          ]
        },
        "description": "Tool to list all tags with optional filtering and pagination. Use when you need to browse or search tags in your account.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"ordering\": \"\",\n  \"page_size\": 0,\n  \"name__icontains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_list_users",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/users",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "users"
          ]
        },
        "description": "Tool to list all users with optional filtering, searching, ordering, and pagination. Use when you need to retrieve user records across your organization.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0,\n  \"search\": \"\",\n  \"ordering\": \"\",\n  \"page_size\": 0,\n  \"email__exact\": \"\",\n  \"organization\": 0,\n  \"customer_plan\": \"\",\n  \"date_joined__gt\": \"\",\n  \"date_joined__lt\": \"\",\n  \"username__exact\": \"\",\n  \"date_joined__gte\": \"\",\n  \"date_joined__lte\": \"\",\n  \"email__icontains\": \"\",\n  \"last_name__exact\": \"\",\n  \"first_name__exact\": \"\",\n  \"subscription_state\": \"\",\n  \"username__icontains\": \"\",\n  \"last_name__icontains\": \"\",\n  \"first_name__icontains\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_period_overview",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/period/overview",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "period",
            "overview"
          ]
        },
        "description": "Tool to get period overview analytics for products including counts, impressions, and conversion percentage. Use after specifying the product_type and time interval.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"organization\": 0,\n  \"product_type\": \"\",\n  \"to_timestamp\": 0,\n  \"from_timestamp\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_product_overview",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/product/overview",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "product",
            "overview"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"organization\": 0,\n  \"product_type\": \"\",\n  \"to_timestamp\": 0,\n  \"from_timestamp\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_retrieve_qr_code",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/qr/code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "qr",
            "code"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_retrieve_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "user"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_update_place",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/place",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "place"
          ]
        },
        "description": "Tool to update the specified Place by ID. Use after retrieving the Place to modify its details, such as name, address, or coordinates.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"address\": \"\",\n  \"latitude\": 0,\n  \"place_id\": 0,\n  \"longitude\": 0,\n  \"organization\": 0,\n  \"business_color\": \"\",\n  \"business_icon_url\": \"\",\n  \"business_cover_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_update_qr_code",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/qr/code",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "qr",
            "code"
          ]
        },
        "description": "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",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"meta\": {},\n  \"name\": \"\",\n  \"tags\": \"\",\n  \"place\": 0,\n  \"qr_type\": 0,\n  \"campaign\": {},\n  \"qrcode_id\": 0,\n  \"attributes\": {},\n  \"fields_data\": {},\n  \"organization\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_update_tag",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/tag",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "tag"
          ]
        },
        "description": "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.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"color\": \"\",\n  \"tag_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "beaconstac_update_user",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/user",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "user"
          ]
        },
        "description": "Tool to update an existing User. Use when you need to modify profile details or organization of a User by their ID.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"user_id\": 0,\n  \"last_name\": \"\",\n  \"first_name\": \"\",\n  \"organization\": 0,\n  \"profile_picture\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}