Maci MCP server
Commit Oct 30, 2026Allows AI assistants to read refrigeration unit data, service history, F-gas logs, and alarms through the Maci API.
Also known as Maci-Intelligence/developers, mcp
- Stars
- 0
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 30, 2026
- License
- —
What is Maci MCP?
Maci allows AI assistants to read refrigeration unit data, service history, F-gas logs, and alarms through the Maci API. It exposes 10 tools, such as list_sites, list_units, get_unit.
Summary generated from the project's README
About Maci MCP server
Maci provides a read-only connection between refrigeration management data and AI assistants using the Model Context Protocol. This server allows users to query refrigeration unit details, service histories, F-gas logs, and active alarms through a remote HTTP transport. It is designed for organizational admins who need to integrate their existing Maci data into tools like Claude, ChatGPT, or Claude Code.
Users interact with the system by asking natural language questions about their equipment. The server utilizes specific tools such as list_units, get_unit, list_service_entries, and list_alarms to retrieve information. It can also access F-gas status and usage limits if the Maci Service is active. The assistant handles pagination automatically for lists up to 100 items per page.
Security is managed via OAuth 2.1 with PKCE, requiring users to log in through the Maci platform to authorize the connection. The assistant only accesses data that the specific organization is already permitted to see. Every tool interaction counts as an API call, and administrators can monitor or revoke connections through the Maci app.
What you can do with it
- 1Identify upcoming maintenance needsAsk the assistant to find which refrigeration units require a leak check during a specific month.
- 2Monitor active equipment alarmsRequest a summary of open alarms at a specific location and check if they have been addressed.
- 3Review unit service historyInquire about the last time a specific unit was serviced and the details of the work performed.
Written from the project's README. Every use case is checked against a quote from it.
How to install Maci MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Maci MCP in Claude Code
$ claude mcp add --transport http mcp https://mcp.maci.energy/mcpInstall Maci MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.maci.energy/mcp"
}
}
}Install Maci MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.maci.energy/mcp"
}
}
}Install Maci MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.maci.energy/mcp"}'Install Maci MCP in Codex
$ codex mcp add mcp --url https://mcp.maci.energy/mcpInstall Maci MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://mcp.maci.energy/mcp"
Install Maci MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://mcp.maci.energy/mcpInstall Maci MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.maci.energy/mcp",
"type": "http"
}
}
}Maci MCP tools 10
Detected from the READMElist_siteslist_unitsget_unitlist_componentslist_service_entriesget_fgas_statuslist_fgas_entrieslist_alarmsget_alarmget_usage
| list_sites | — | |
| list_units | — | |
| get_unit | — | |
| list_components | — | |
| list_service_entries | — | |
| get_fgas_status | — | |
| list_fgas_entries | — | |
| list_alarms | — | |
| get_alarm | — | |
| get_usage | — |
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemaci-intelligence/developers is public and reachablegithub.com/maci-intelligence/developers ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-30github.com/maci-intelligence/developers ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model10 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMaci for AI assistants (MCP)
Connect Maci to an assistant that speaks the Model Context Protocol and ask about your refrigeration units in your own words:
- Which of our units are due a leak check in November?
- Are there open alarms at the Vesterbro store, and has anyone taken them?
- When was MC-0482 last serviced, and what was done?
https://mcp.maci.energy/mcp
The server is read only. It reads through Maci's API, so the assistant sees what your organisation may see in Maci and nothing more, and every tool call counts as an API call. The full guide is at api.maci.energy/docs/ai-assistants.
Connect
Claude (claude.ai and the desktop app): Settings → Connectors → Add custom connector. Name it Maci, paste the address above and choose Connect.
ChatGPT: Settings → Connectors, add a custom connector with the address above. (ChatGPT may ask you to turn on developer mode for custom connectors.)
Claude Code:
claude mcp add --transport http maci https://mcp.maci.energy/mcp
Then run /mcp in Claude Code and choose Maci to log in.
Cursor, VS Code and others: see clients.md.
In each case the assistant sends you to Maci. Log in as always, choose the organisation and say yes with your passkey. Only an organisation's admin can connect it.
Tools
| Tool | What it gives | Scope |
|---|---|---|
list_sites |
The organisation's sites, and customers' sites it has units on through a grant | units:read |
list_units |
The units it works with, filtered by site, status or what changed since a time | units:read |
get_unit |
One unit's passport: master data, nameplate, refrigerant, charge, CO2 equivalent, components | units:read |
list_components |
A unit's components | units:read |
list_service_entries |
A unit's service history | service:read |
get_fgas_status |
A unit's leak check status: interval, last check, next due (needs Maci Service) | fgas:read |
list_fgas_entries |
A unit's F-log (needs Maci Service) | fgas:read |
list_alarms |
Alarms from Maci Intelligence, filtered by open, unit or since a time | alarms:read |
get_alarm |
One alarm with its values, who took it and how it was closed | alarms:read |
get_usage |
This month's calls and the limit | any |
Lists come in pages of up to 100; the assistant follows next_cursor by itself.
Skills
Instructions that walk the assistant through a task, step by step. Give one to the assistant (in Claude: add it as a skill, or paste it into the conversation) and ask for the task.
| Skill | What it does |
|---|---|
| Leak check plan | The units due a leak check in a period, by site, with the overdue ones first |
| F-gas overview | Refrigerant, charge and CO2 equivalent by site, and the units without a leak check status |
| Alarm report | A period's alarms: how many, how fast they were taken, how many were false |
| Before a visit | What a technician should know before going to a unit |
More examples of questions: prompts.md.
Your data
The assistant reads only, and only what your organisation may see. What it reads goes to the assistant you chose and its provider, so connect only an assistant your organisation is allowed to use. Each connection is listed in the app under Konto → API-nøgler, "Forbundne AI-assistenter", with who made it and when it was last used. Removing it stops it at once, and a connection that is not used for 30 days ends by itself.
For developers
The server follows the MCP specification of 2026-07-28: Streamable HTTP, OAuth 2.1 with PKCE (S256), Client ID
Metadata Documents and dynamic client registration, with app.maci.energy as the authorization server. Details in the
guide.
Maci MCP questions
How do I add Maci MCP to Claude Code?
Run claude mcp add --transport http mcp https://mcp.maci.energy/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Maci MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Maci MCP provide?
It exposes 10 tools, including list_sites, list_units, get_unit, list_components, list_service_entries.
Can the AI assistant make changes to my data?
No, the server is read-only and only provides access to what your organization is already permitted to see.
How do I connect Maci to Claude?
Go to Settings → Connectors → Add custom connector, name it Maci, paste the provided URL, and click Connect.
Who is allowed to connect the Maci server?
Only an administrator of the organization can establish a connection.
What happens to unused connections?
Any connection that has not been used for 30 days will automatically end.