Developers

Connect your building data to AI assistants and your own systems

BrickFlow has an MCP server, so AI assistants such as Claude and ChatGPT can work with the data in your account, and a REST API for your own systems and scripts. Both see only what you can see.

Connect an AI assistant (MCP)

BrickFlow speaks the Model Context Protocol (MCP), so an assistant can answer questions about your buildings, meters, bills, emissions and targets in its own conversation, and make changes you allow. Its address ishttps://app.brickflow.site/api/v1/mcp.

A second address has the same tools and the same sign-in:

AddressWhat you get
https://wild-spark-25ny6.run.mcp-use.com/mcpThe BrickFlow app: every BrickFlow tool, plus charts and cards for your portfolio, a building, bills, a meter, emissions, targets, sources, alerts and your access.
https://app.brickflow.site/api/v1/mcpBrickFlow’s own MCP server: every BrickFlow tool, answered as text.

Claude and ChatGPT: sign in with BrickFlow

No token to copy. You sign in on BrickFlow’s own page and choose what the assistant may do.

  1. Claude: open Settings, Connectors, and choose Add custom connector. Paste one of the addresses above, leave the advanced settings empty, and choose Connect. ChatGPT: turn on developer mode, then add a connector with the same address.
  2. Sign in to BrickFlow when asked, pick the organization, and choose Read only or Read and change data.
  3. Ask about your buildings. The assistant can use BrickFlow until you disconnect it.

You stay connected: the assistant renews its access by itself, so you do not sign in again every hour. A connection ends when you disconnect it in BrickFlow under Profile, API tokens, Connected apps, or when nobody has used it for 90 days. The assistant sees only what you see in that one organization, at your role as it stands at the time of each request, and changes data only if you chose Read and change data.

Claude Code, Cursor and other clients

Clients that run on your computer connect with a personal API token in a header (create one below; choose Look at and change my data if the assistant should make changes).

Claude Code

claude mcp add --transport http brickflow https://app.brickflow.site/api/v1/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor, Windsurf, VS Code and other clients that read an mcpServers file:

{
  "mcpServers": {
    "brickflow": {
      "type": "http",
      "url": "https://app.brickflow.site/api/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Claude Desktop starts only local servers, so it reaches BrickFlow through the mcp-remote bridge: use the command npx with the arguments mcp-remote, the address and--header "Authorization: Bearer YOUR_TOKEN", or add BrickFlow as a connector with Claude instead.

What the assistant can do

AreaWhat it coversTools
Buildings and spacesSites, buildings, floors, rooms, equipment, leases, occupancy, certifications and dated building facts.list_buildings, get_building_summary, list_floors, list_equipment, list_leases, get_occupancy, list_certifications, get_building_history
Meters and readingsMeters with their units, monthly totals, readings with their source, interval data and load profiles.list_meters, get_meter_monthly_totals, get_meter_readings, list_interval_meters, get_load_profile, get_reading_sources, list_unattached_meters
Energy, emissions and reportsPortfolio totals, Scope 1 and 2 emissions, energy use and intensity, ENERGY STAR metrics, Scope 3 and saved reports.get_portfolio_summary, get_emissions, get_energy_use, get_energy_intensity, get_energy_star_metrics, list_reports, get_report, list_scope3_entries
Bills and costsSearch bills, open one bill and its charge lines, coverage by month, peak demand and costs per meter.search_bills, get_bill, get_bill_costs, get_bill_coverage, get_bill_summary, get_peak_demand, get_data_coverage
Alerts and insightsThe alerts BrickFlow raised and what it noticed, most serious first.list_alerts, list_insights, list_data_issues, list_reading_conflicts
Targets and financeTargets and their progress, GRESB answers, property values, utility budgets and exchange rates.list_targets, get_target_progress, get_targets_summary, get_gresb, list_property_values, list_utility_budgets, get_exchange_rates
Sources and documentsConnected sources, imports, uploaded documents and spreadsheets, projects and deadlines.list_data_sources, list_import_jobs, list_documents, get_document, list_uploads, list_projects, get_calendar
Access and sharingYour organization and role, the places you were granted, and what other organizations shared with you.get_organization, get_my_access, list_shared_with_me, get_shared_building
Changes and connecting sourcesUpload a bill or spreadsheet, review an alert, connect ENERGY STAR Portfolio Manager or Green Button, and other changes you could make yourself. Anything that removes data first says what would go and waits for a second yes.upload_bill, upload_spreadsheet, review_alert, connect_energy_star, connect_green_button, find_change, change_brickflow

Any read the list does not cover is still reachable through read_brickflow. Changes are offered only to a sign-in with Read and change data, or a token made to look at and change your data, and never reach people, tokens, billing or passwords. MCP calls count toward your daily call allowance; on the Free plan MCP has its own allowance (see pricing).

REST API

Base URL

Every request goes to https://app.brickflow.site/api/v1 over HTTPS.

Create an API token

  1. Sign in to BrickFlow at app.brickflow.site. If you do not have an account yet, get started.
  2. Open your profile and choose API tokens (app.brickflow.site/profile?tab=tokens).
  3. Create a token and give it a name that says what will use it. Choose what it can do: Look at my data,Read reports only, or Look at and change my data. A token that only looks can be limited to chosen buildings and kinds of data. Every token expires within a year; you can choose an earlier date.
  4. Copy the token when it appears. BrickFlow shows it once and keeps only a hash of it, so it cannot show it to you again.

Tokens are personal: each one belongs to the person who created it and reads one organization’s data. You can revoke your tokens in the same place at any time. Use one token per integration, so that revoking one affects nothing else, and keep each token as secret as a password.

Make a request

Send the token in the Authorization header, with the word Bearer written exactly as shown:

curl -H "Authorization: Bearer YOUR_TOKEN" \
  https://app.brickflow.site/api/v1/portfolio/summary

This returns counts of the buildings, spaces, equipment and data series the token can read. Successful responses are JSON.

What a token can do

  • A token made with Look at my data or Read reports only only reads. It cannot add, change or delete anything.
  • A token made with Look at and change my data can also make the changes you could make yourself in that organization. It is offered only to people whose role can change data.
  • A token without limits reads what you can read in BrickFlow. A limited token reads only the buildings and kinds of data you chose.
  • Every request is checked against your access at that moment, so when your own access changes, your tokens follow.
  • Some areas are not open to tokens, including billing, invitations, passwords and sign-in, and the tokens themselves. A token that can change data never manages people, tokens, billing or passwords.

The API reference lists every endpoint a token can call, grouped by what it does, with which kind of token each one takes, its parameters and its replies.

Replies and errors

StatusMeaning
200Success, with a JSON body.
401The token is missing, malformed, revoked or expired.
402Your organization’s subscription is not active.
403The token’s access does not cover what you asked for.
404There is no API endpoint at that address.

Each refusal carries a short message that says why.

Call it from a server

The API does not send CORS headers, so a browser blocks calls to it from a web page on another site. Call it from your own server, a script or an integration tool, where the token stays private.

Plans and allowances

API access and call allowances depend on each building’s plan. See pricing.

Service status

GET https://app.brickflow.site/healthz returns ok while the app is running.

For AI agents

AI agents can read the brickflow-api agent skill, which sets out the same facts and how an agent should handle a person’s token.

Questions

Email [email protected] with questions about an endpoint or the data it returns. Report a security issue to [email protected].