MewCP Google Gemini MCP

Access Google's most capable AI models through a single MCP tool.

A Model Context Protocol (MCP) server that exposes Google Gemini's API for generating text using state-of-the-art large language models.

The mewcp-gemini MCP Server provides direct access to Google's Gemini LLMs:

- Generate high-quality text responses from natural language prompts
- Choose between fast and capable Gemini model variants
- Integrate Gemini's reasoning into any MCP-compatible AI workflow

- AI agents that need to delegate subtasks to a powerful LLM
- Generating summaries, translations, code, or creative content
- Augmenting workflows with Gemini's reasoning and language capabilities

- query (string, required) — Required. Natural language prompt to send to Gemini. Any text is accepted; no length limit is enforced by this tool. - model (string, optional, default: gemini-2.5-flash) — Optional. Gemini model name, e.g., 'gemini-2.5-flash' or 'gemini-2.5-pro'. Defaults to 'gemini-2.5-flash'.

Every tool returns the same top-level envelope. Onlydatavaries per tool.

// Success { "success": true, "statusCode": 200, "retriable": false, "retry_after_seconds": null, "error": null, "data": { ... } } // Error { "success": false, "statusCode": 400, "retriable": false, "retry_after_seconds": null, "error": { "code": "{ERROR_CODE}", "message": "{description}", "details": {} }, "data": null }

- retriable—truewhen it is safe to retry (rate limit, network error, 503).falsefor validation and auth errors.
- retry_after_seconds— seconds to wait before retrying; present only whenretriableistrueand the upstream specifies a delay.
- error.code— machine-readable string:VALIDATION_ERROR,AUTH_ERROR,UPSTREAM_ERROR,SERVER_ERROR.

- Cause:API key not provided in request headers or incorrect format
- Solution:
- VerifyAuthorization: Bearer YOUR_API_KEYandX-Mewcp-Credential-Id: CREDENTIAL-IDheaders are present
- Check API key is active in your MewCP account

- Cause:API calls have exceeded your request limits
- Solution:
- Check credit usage in your Curious Layer dashboard
- Upgrade to a paid plan or add credits for higher limits
- Contact support for credit adjustments

- Cause:No Gemini credential linked to your account
- Solution:
- Go toCredentialsin your MewCP dashboard
- Add your API key (static)
- Retry the request with the correctX-Mewcp-Credential-Idheader

- Cause:JSON payload is invalid or missing required fields
- Solution:
- Validate JSON syntax before sending
- Ensure all required tool parameters are included
- Check parameter types match expected values

- Cause:Incorrect server name in the API endpoint
- Solution:
- Verify endpoint format:mewcp-gemini/mcp/generate_text
- Use correct server name from documentation
- Check available servers in your Curious Layer account

- Cause:Upstream Gemini API returned an error
- Solution:
- Check Gemini service status atGoogle Status Page
- Verify your credential has the required permissions
- Review the error message for specific details

- Gemini API Documentation— Official API reference
- Gemini API Reference— Complete endpoint reference
- FastMCP Docs— FastMCP specification
- FastMCP Credentials— FastMCP Credentials package for credential handling

Interact with and manage your Ghost CMS blog, including posts, users, and members, through an LLM interface.