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](https://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](/dashboard/apikeys) (it starts with `eq_` and is shown once), then add Equibles to `~/.gemini/settings.json` under `mcpServers`:

```json
{
  "mcpServers": {
    "equibles": {
      "httpUrl": "https://mcp.equibles.com/mcp",
      "headers": { "Authorization": "Bearer eq_your_api_key" }
    }
  }
}
```

> A streamable-HTTP server uses the `httpUrl` key (not `url`, which is for SSE endpoints). For a single project, put the same block in `.gemini/settings.json` at the project root.

## 3. Test it

Start `gemini` and ask any of these — it should call an Equibles tool:

<div class="doc-prompts">
  <div class="doc-prompt"><span class="q">›</span> Show me Apple's last five daily closes. <span class="tag">Prices</span></div>
  <div class="doc-prompt"><span class="q">›</span> Who are NVIDIA's top institutional holders this quarter? <span class="tag">13F</span></div>
  <div class="doc-prompt"><span class="q">›</span> Summarize Microsoft's most recent earnings call. <span class="tag">Earnings</span></div>
</div>

## Troubleshooting

<details class="doc-ts"><summary>Server not appearing?</summary>
<div class="doc-ts-body">

Restart the CLI after editing `settings.json`, then run `/mcp` inside `gemini` to confirm Equibles is listed and connected.

</div>
</details>

<details class="doc-ts"><summary>Model answers without Equibles data?</summary>
<div class="doc-ts-body">

Tell it explicitly to "use the Equibles MCP server" in your prompt.

</div>
</details>

<details class="doc-ts"><summary>401 / access denied?</summary>
<div class="doc-ts-body">

Your key is missing or wrong — re-copy it from [/dashboard/apikeys](/dashboard/apikeys) into the `Authorization` header. If you're over your daily limit, see [Rate limits](/docs/rate-limits).

</div>
</details>