The Gemini CLI connects to the Equibles MCP server through its settings.json, authenticated with an API key.
1. Install the Gemini CLI
Install it from github.com/google-gemini/gemini-cli, then run gemini once to sign in.
2. Add the Equibles server
Create an API key at /dashboard/apikeys (it starts with eq_ and is shown once), then add Equibles to ~/.gemini/settings.json under mcpServers:
{
"mcpServers": {
"equibles": {
"httpUrl": "https://mcp.equibles.com/mcp",
"headers": { "Authorization": "Bearer eq_your_api_key" }
}
}
}
A streamable-HTTP server uses the
httpUrlkey (noturl, which is for SSE endpoints). For a single project, put the same block in.gemini/settings.jsonat the project root.
3. Test it
Start gemini and ask any of these, and it should call an Equibles tool. Name Equibles in the prompt, "using Equibles, ...", or the model may answer from memory or from a web search instead of the sourced data:
Troubleshooting
Connected but requests fail? See shared connection troubleshooting for OAuth sign-in and API-key errors. Keep the setup URL above if your connection works.
Server not appearing?
Restart the CLI after editing settings.json, then run /mcp inside gemini to confirm Equibles is listed and connected.
Model answers without Equibles data?
It answered from memory or from a web search. Start the prompt with "using Equibles, ..." so it calls the tools.
401 / access denied?
Your key is missing or wrong. Put the full key in the Authorization header: the one you copied when you created it, not the shortened prefix the dashboard lists later. If you no longer have it, create a new one at /dashboard/apikeys. If you're over your daily limit, see Plans & limits.