Gemini MCP Server — Hosted Ai Integration
MCP Server language Hosted language PublicGoogle Gemini AI — generate content, embed text, count tokens, and run system-instructed completions.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"gemini": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-gemini",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify gemini credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-gemini — Gemini MCP Server
Google Gemini AI — generate content, embed text, count tokens, and run system-instructed completions.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-gemini
What You Can Do
This MCP server gives AI agents access to Gemini via 6 tools. Connect it to any Aerostack workspace and your agents can interact with Gemini directly.
Available Tools
| Tool | Description |
|---|---|
generate_content |
Generate content using a Gemini model. Supports text generation with optional temperature and token controls. Default model is gemini-2.0-flash. |
list_models |
List all available Gemini models with their capabilities, token limits, and supported generation methods. |
get_model |
Get detailed information about a specific Gemini model including token limits and supported methods. |
count_tokens |
Count the number of tokens in a prompt without generating a response. Useful for estimating costs. |
embed_content |
Generate text embeddings using text-embedding-004 model. Returns a 768-dimensional embedding vector for semantic search, clustering, or similarity tasks. |
generate_with_system |
Generate content with a system instruction that sets the model persona and context. More powerful than a regular system prompt in many use cases. |
Configuration
| Variable | Required | Description |
|---|---|---|
GEMINI_API_KEY |
Yes | Your GEMINI API KEY from the service's developer settings |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Gemini" and click Add to Workspace
Add the following secrets under Project → Secrets:
GEMINI_API_KEY
Once added, every AI agent in your workspace can use Gemini tools automatically.
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-gemini \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-GEMINI-API-KEY: your-gemini-api-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_content","arguments":{}}}'
License
MIT
terminal Tools (7)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Gemini credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
generate_content #2 Generate content using a Gemini model. Supports text generation with optional temperature and token controls. Default model is gemini-2.0-flash.
list_models #3 List all available Gemini models with their capabilities, token limits, and supported generation methods.
get_model #4 Get detailed information about a specific Gemini model including token limits and supported methods.
count_tokens #5 Count the number of tokens in a prompt without generating a response. Useful for estimating costs.
embed_content #6 Generate text embeddings using text-embedding-004 model. Returns a 768-dimensional embedding vector for semantic search, clustering, or similarity tasks.
generate_with_system #7 Generate content with a system instruction that sets the model persona and context. More powerful than a regular system prompt in many use cases.
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-gemini
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in AI
Browse AI MCPs →Canva Design Platform
by @aerostack
Design creation, AI generation, editing, export, assets, brand kits, folders via Canva's official MCP
Intercom Messaging
by @aerostack
Conversations, contacts, tickets, articles via Intercom's official MCP
Anthropic
by @aerostack
Call Claude models directly — run AI conversations, tool-use chains, batch jobs, and model comparisons from any agent.
Vercel Deployments
by @aerostack
Deployments, projects, domains, env vars, logs via Vercel's official MCP
Gmail
by @aerostack
Read, send, and search Gmail messages — manage labels, drafts, and attachments with full inbox control.
Mailchimp
by @aerostack
Manage audiences, campaigns, and subscriber tags in Mailchimp — automate your email marketing with AI.
Frequently asked questions
What is the Gemini MCP server and what can it do? +
The Gemini MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `generate_content`, `list_models`, `get_model`, `count_tokens`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Gemini MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Gemini MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Gemini MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Gemini MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-gemini": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-gemini"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Gemini MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-gemini", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-gemini"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Gemini MCP require authentication? +
Yes. Gemini requires authentication. Check the MCP's documentation for the required credentials.