How to add an MCP server to BoltAI
BoltAI reads its MCP servers from ~/.boltai/mcp.json and connects to them over stdio (a local process).
85,197 of the 123,403 servers we can write a config for work in it.
A local server
A local server runs on your machine, started by BoltAI from its package. It needs Node.js installed first. For example, Azure MCP Server goes in ~/.boltai/mcp.json:
{
"mcpServers": {
"azure": {
"command": "npx",
"args": ["-y", "@azure/[email protected]", "server", "start"]
}
}
}Which servers work in BoltAI
BoltAI cannot send a header to a remote server, so the 3,272 servers that need a key in one do not work in it.
| Runs | Servers | In BoltAI? |
|---|---|---|
| Local (stdio) | 85,197 | Works |
| Remote, Streamable HTTP | 31,223 | No |
| Remote, Streamable HTTP, key in a header | 3,225 | No |
| Remote, HTTP+SSE | 3,711 | No |
| Remote, HTTP+SSE, key in a header | 47 | No |
If the server does not show up
- A remote server that does not connect
- The environment variables servers ask for
- BoltAI's own MCP documentation
Matches the official docs The configs follow BoltAI's MCP docs, read on 2026-10-31.