Kairom MCP server
Commit Oct 14, 2026Simulates complex system dependencies and economic shocks across European infrastructure, energy, and supply chains.
Also known as dfifth/mcp, mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 14, 2026
- License
- —
What is Kairom MCP?
Kairom simulates complex system dependencies and economic shocks across European infrastructure, energy, and supply chains.
Summary generated from the project's README
About Kairom MCP server
Simulating complex system dependencies and economic shocks across European infrastructure is what Kairom enables for analysts and decision-makers. This remote MCP server allows users to investigate how specific sites or companies rely on power, fuel, telecom, roads, rail, and ports. By running what-if scenarios involving strikes, supplier failures, cyber incidents, or natural hazards, users can identify single points of failure within interconnected supply chains and economic sectors.
Because the server is hosted, there is nothing to install locally. Users connect via an HTTP endpoint using OAuth 2.1 with PKCE, making it compatible with Claude, ChatGPT, Claude Code, and other MCP clients like Cursor or VS Code. The server provides 21 read-only tools to query system maps, recent changes, and economic data. While it offers decision support through regional economic output simulations, it functions as a screening layer rather than a source of validated forecasts.
What you can do with it
- 1Identify critical infrastructure vulnerabilitiesAsk the AI to find the single points of failure for a specific industrial plant.
- 2Model the impact of labor strikesSimulate how a multi-day strike at a major port affects connected systems.
- 3Analyze cross-system supply chain risksDetermine which interconnected chains could potentially harm a specific company project.
- 4Monitor regional economic fluctuationsCompare current electricity prices in a specific country against recent historical trends.
Written from the project's README. Every use case is checked against a quote from it.
How to install Kairom MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Kairom MCP in Claude Code
$ claude mcp add --transport http mcp https://kairom.world/mcpInstall Kairom MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://kairom.world/mcp"
}
}
}Install Kairom MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://kairom.world/mcp"
}
}
}Install Kairom MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://kairom.world/mcp"}'Install Kairom MCP in Codex
$ codex mcp add mcp --url https://kairom.world/mcpInstall Kairom MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://kairom.world/mcp"
Install Kairom MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://kairom.world/mcpInstall Kairom MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://kairom.world/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 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 reachabledfifth/mcp is public and reachablegithub.com/dfifth/mcp ↗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-14github.com/dfifth/mcp ↗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 model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeEndpoint did not answer initialize: HTTP 503Finding
README
View on GitHubKairom MCP server
Kairom is a complex-systems data, simulation and decision engine for Europe. Ask what a site or a company depends on (power, fuel, telecom, cyber, roads, rail and ports, suppliers, economy by sector, people and events, health, regulation) and run what-if shocks through those systems: strikes, supplier failure, power or telecom outages, cyber incidents, price and regulation shocks, crowd events, and natural hazards as one input among many.
This repository holds the documentation and the registry metadata of the remote Kairom MCP server. The server itself is hosted; there is nothing to install or run.
- Endpoint:
https://kairom.world/mcp(MCP Streamable HTTP, OAuth 2.1 with PKCE) - Tools: 21, all read-only (list in TOOLS.md)
- API reference: https://kairom.world/docs (REST:
/api/tools/*,/api/v2, OpenAPI at https://kairom.world/openapi-tools.json) - Public demo (no sign-up, read-only, three fictional companies): https://kairom.world/app/i#OIMI983P1F34O8tFtwct7Ah2MbxHwpwxKppUYakWlKo
Connect
Claude (Free, Pro, Max): Settings → Connectors → Add custom connector → https://kairom.world/mcp → Add → Connect.
On the Kairom page that opens, paste the demo link above (or your own invite link). One-click:
Add Kairom to Claude.
Team and Enterprise: an Owner adds it under Organization settings → Connectors.
ChatGPT (Plus, Pro, Business, Enterprise): Settings → Apps & Connectors → Advanced settings → turn on Developer mode →
Create → name "Kairom", URL https://kairom.world/mcp → sign in with the demo link.
Claude Code:
claude mcp add --transport http kairom https://kairom.world/mcp
Any other MCP client that supports remote servers with OAuth (Cursor, VS Code, Cline, ...): add a remote/HTTP server
with the URL https://kairom.world/mcp; the client opens the Kairom sign-in page. See llms-install.md.
API key instead of OAuth: workspace keys (Authorization: Bearer kw_...) are issued from the app's API keys page
for pilot workspaces.
What to ask
- What does the plant at Pol. Malpica, Zaragoza depend on, and where are its single points of failure?
- Run a 5-day strike at the Port of Valencia and show what is hit first.
- For my company project, which cross-system chains can hurt us and which can help us? (
get_system_map) - What changed this week around my sites? (
recent_changes) - What is the electricity price in Spain today against the last 7 days?
How to read the answers
Every result carries status (validated / screening / experimental), as_of, sources and caveats, and ranges
(p10-p90 or 90 %) where the engine has them. Most layers are screening today: orders of magnitude, not validated
forecasts. Simulation results are regional economic output (GVA) over the run, not a company's own accounts. Decision support
only: no tool takes an action, and official warnings and operators' notices take precedence.
Limits and privacy
- Rate limits per key or connection (HTTP 429 with
Retry-After); the demo link has a per-visitor limit. - Each key or connection only ever reads its own workspace. The demo link cannot edit anything or use the AI layer.
- Logs keep the tool name, a key id prefix and positions rounded to about 1 km; never request bodies, addresses or tokens.
- Data comes from open sources with attribution: https://kairom.world/api/v1/attribution
Contact
Pau, Kairom (Barcelona) · pau@kairom.world · https://kairom.world · Legal and privacy: https://kairom.world/legal
Documentation in this repository: CC BY 4.0.
Kairom MCP questions
How do I add Kairom MCP to Claude Code?
Run claude mcp add --transport http mcp https://kairom.world/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Kairom MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can the server take actions on my behalf?
No, the tools are read-only and intended for decision support only; no tool takes an action.
Does the server require installation?
No, the server is hosted remotely and does not require local installation.