FairMind — Claude Code MCP server: features and setup
The FairMind MCP server for Claude Code checks whether an AI system can ship and runs fairness tests on CSV files. The agent can call it to review a release gate or inspect a local dataset.
AGPL-3.0 ★ 17 updated 2026-11-16
claude mcp add fairmind -e FAIRMIND_API_URL=<FAIRMIND_API_URL> -e FAIRMIND_API_KEY=<FAIRMIND_API_KEY> -- uvx fairmind-mcpWhat FairMind does
FairMind returns a release decision for an AI system and can test fairness using CSV files on the machine. Its tools expose systems visible to the API key, explain gate results, and map checks to regulatory clauses. It can also save test results as evidence and compare recent decisions with the latest fairness run for drift and impact ratio.
Evaluations can use local files, a connected agent platform, or a live system. Behaviour checks run as background jobs and may take minutes. The server needs FAIRMIND_API_URL and FAIRMIND_API_KEY, and communicates with FairMind over stdio. Evaluation tools use the key’s first organisation unless FAIRMIND_ORG_ID selects another.
What it helps with
- check whether an AI system clears its release gate
- run a fairness test on a local CSV
- compare recent decisions with the latest test results
- inspect a gate against regulatory clauses
Example prompts for the agent
- Check whether the credit-scoring system is cleared for release.
- Run a fairness test on
holdout.csvby gender and region, usingrepaidas the outcome andapprovedas the prediction. - Compare recent decisions in the CSV with the latest fairness run.
How to install FairMind
Platform CLI
claude mcp add fairmind -e FAIRMIND_API_URL=<FAIRMIND_API_URL> -e FAIRMIND_API_KEY=<FAIRMIND_API_KEY> -- uvx fairmind-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fairmind-mcp <command>
Platform CLI
codex mcp add mcp --env FAIRMIND_API_URL=<FAIRMIND_API_URL> --env FAIRMIND_API_KEY=<FAIRMIND_API_KEY> -- uvx fairmind-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fairmind-mcp <command>
Config file
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"fairmind-mcp"
],
"env": {
"FAIRMIND_API_URL": "<FAIRMIND_API_URL>",
"FAIRMIND_API_KEY": "<FAIRMIND_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fairmind-mcp <command>
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fairmind-mcp"
],
"env": {
"FAIRMIND_API_URL": "<FAIRMIND_API_URL>",
"FAIRMIND_API_KEY": "<FAIRMIND_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fairmind-mcp <command>
Platform CLI
gemini mcp add -e FAIRMIND_API_URL=<FAIRMIND_API_URL> -e FAIRMIND_API_KEY=<FAIRMIND_API_KEY> mcp uvx fairmind-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fairmind-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about FairMind
How do I install FairMind in Claude Code?
Add the server with claude mcp add fairmind -e FAIRMIND_API_URL=<FAIRMIND_API_URL> -e FAIRMIND_API_KEY=<FAIRMIND_API_KEY> -- uvx fairmind-mcp.
What does FairMind do?
It checks release readiness for AI systems, runs evaluations on files or live systems, and records results as evidence.
What does FairMind require?
Set the FairMind API URL in FAIRMIND_API_URL and provide an API key through FAIRMIND_API_KEY. Set FAIRMIND_ORG_ID to use an organisation other than the key’s first one.