KosmoKrator

data

Google Gemini MCP Gateway for AI Agents

Expose Google Gemini tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

Google Gemini MCP Gateway

Expose Google Gemini to MCP clients with `kosmokrator mcp:serve --integration=google-gemini`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server.

Install KosmoKrator 
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash
Install gateway entry 
kosmokrator mcp:gateway:install --integration=google-gemini --write=deny --json
MCP configuration 
{
  "mcpServers": {
    "kosmokrator-google-gemini": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=google-gemini",
        "--write=deny"
      ]
    }
  }
}
Serve manually 
kosmokrator mcp:serve --integration=google-gemini --write=deny

Client Notes

Use one scoped MCP gateway entry, then adapt the config location to the client or framework.

Claude Code Connect local KosmoKrator integrations to Claude Code through one scoped MCP gateway entry. Claude Code can launch the local kosmo binary directly from the project MCP config.
Cursor Expose selected local integrations to Cursor through KosmoKrator without configuring each service as its own MCP server. Use the same KosmoKrator install and integration credentials that power terminal and headless runs.
Codex Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy. Keep write access denied or ask-based unless the workspace is trusted.
OpenAI Agents SDK Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway. Use headless JSON commands for CI-style execution and MCP for agent tool discovery.
Claude Agent SDK Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server. Use a narrow integration list so the agent does not load unrelated tools.
Vercel AI SDK Use KosmoKrator as a local integration gateway for Vercel AI SDK agents and scripts. Prefer CLI JSON calls when a workflow only needs one deterministic integration operation.
LangChain Bridge LangChain agents to local KosmoKrator integration tools through MCP or headless CLI calls. Keep the gateway scoped to the integration and operation class needed by the chain.
LangGraph Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions. Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.
CrewAI Expose KosmoKrator integrations to CrewAI workers as scoped local tools. Use per-worker integration scopes to avoid giving every worker every tool.
Generic MCP Clients Connect any stdio-compatible MCP client to local KosmoKrator integration tools. Start with read-only write policy and expand only for trusted projects.

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names.

MCP toolSource functionType
integration__google_gemini__google_gemini_cached_contents_patch google-gemini.google_gemini_cached_contents_patch Write write
integration__google_gemini__google_gemini_cached_contents_create google-gemini.google_gemini_cached_contents_create Write write
integration__google_gemini__google_gemini_cached_contents_get google-gemini.google_gemini_cached_contents_get Read read
integration__google_gemini__google_gemini_cached_contents_list google-gemini.google_gemini_cached_contents_list Read read
integration__google_gemini__google_gemini_cached_contents_delete google-gemini.google_gemini_cached_contents_delete Write write
integration__google_gemini__google_gemini_file_search_stores_create google-gemini.google_gemini_file_search_stores_create Write write
integration__google_gemini__google_gemini_file_search_stores_get google-gemini.google_gemini_file_search_stores_get Read read
integration__google_gemini__google_gemini_file_search_stores_delete google-gemini.google_gemini_file_search_stores_delete Write write
integration__google_gemini__google_gemini_file_search_stores_import_file google-gemini.google_gemini_file_search_stores_import_file Write write
integration__google_gemini__google_gemini_file_search_stores_list google-gemini.google_gemini_file_search_stores_list Read read
integration__google_gemini__google_gemini_file_search_stores_operations_get google-gemini.google_gemini_file_search_stores_operations_get Read read
integration__google_gemini__google_gemini_file_search_stores_documents_delete google-gemini.google_gemini_file_search_stores_documents_delete Write write
integration__google_gemini__google_gemini_file_search_stores_documents_get google-gemini.google_gemini_file_search_stores_documents_get Read read
integration__google_gemini__google_gemini_file_search_stores_documents_list google-gemini.google_gemini_file_search_stores_documents_list Read read
integration__google_gemini__google_gemini_file_search_stores_upload_operations_get google-gemini.google_gemini_file_search_stores_upload_operations_get Read read
integration__google_gemini__google_gemini_batches_cancel google-gemini.google_gemini_batches_cancel Write write
integration__google_gemini__google_gemini_batches_get google-gemini.google_gemini_batches_get Read read
integration__google_gemini__google_gemini_batches_list google-gemini.google_gemini_batches_list Read read
integration__google_gemini__google_gemini_batches_delete google-gemini.google_gemini_batches_delete Write write
integration__google_gemini__google_gemini_batches_update_generate_content_batch google-gemini.google_gemini_batches_update_generate_content_batch Write write
integration__google_gemini__google_gemini_batches_update_embed_content_batch google-gemini.google_gemini_batches_update_embed_content_batch Write write
integration__google_gemini__google_gemini_dynamic_stream_generate_content google-gemini.google_gemini_dynamic_stream_generate_content Write write
integration__google_gemini__google_gemini_dynamic_generate_content google-gemini.google_gemini_dynamic_generate_content Write write
integration__google_gemini__google_gemini_media_upload google-gemini.google_gemini_media_upload Write write
integration__google_gemini__google_gemini_media_upload_to_file_search_store google-gemini.google_gemini_media_upload_to_file_search_store Write write
integration__google_gemini__google_gemini_corpora_list google-gemini.google_gemini_corpora_list Read read
integration__google_gemini__google_gemini_corpora_create google-gemini.google_gemini_corpora_create Write write
integration__google_gemini__google_gemini_corpora_get google-gemini.google_gemini_corpora_get Read read
integration__google_gemini__google_gemini_corpora_delete google-gemini.google_gemini_corpora_delete Write write
integration__google_gemini__google_gemini_corpora_operations_get google-gemini.google_gemini_corpora_operations_get Read read
integration__google_gemini__google_gemini_corpora_permissions_delete google-gemini.google_gemini_corpora_permissions_delete Write write
integration__google_gemini__google_gemini_corpora_permissions_list google-gemini.google_gemini_corpora_permissions_list Read read
integration__google_gemini__google_gemini_corpora_permissions_create google-gemini.google_gemini_corpora_permissions_create Write write
integration__google_gemini__google_gemini_corpora_permissions_get google-gemini.google_gemini_corpora_permissions_get Read read
integration__google_gemini__google_gemini_corpora_permissions_patch google-gemini.google_gemini_corpora_permissions_patch Write write
integration__google_gemini__google_gemini_files_register google-gemini.google_gemini_files_register Write write
integration__google_gemini__google_gemini_files_list google-gemini.google_gemini_files_list Read read
integration__google_gemini__google_gemini_files_get google-gemini.google_gemini_files_get Read read
integration__google_gemini__google_gemini_files_delete google-gemini.google_gemini_files_delete Write write
integration__google_gemini__google_gemini_tuned_models_stream_generate_content google-gemini.google_gemini_tuned_models_stream_generate_content Write write
integration__google_gemini__google_gemini_tuned_models_batch_generate_content google-gemini.google_gemini_tuned_models_batch_generate_content Write write
integration__google_gemini__google_gemini_tuned_models_get google-gemini.google_gemini_tuned_models_get Read read
integration__google_gemini__google_gemini_tuned_models_create google-gemini.google_gemini_tuned_models_create Write write
integration__google_gemini__google_gemini_tuned_models_list google-gemini.google_gemini_tuned_models_list Read read
integration__google_gemini__google_gemini_tuned_models_generate_text google-gemini.google_gemini_tuned_models_generate_text Write write
integration__google_gemini__google_gemini_tuned_models_delete google-gemini.google_gemini_tuned_models_delete Write write
integration__google_gemini__google_gemini_tuned_models_patch google-gemini.google_gemini_tuned_models_patch Write write
integration__google_gemini__google_gemini_tuned_models_async_batch_embed_content google-gemini.google_gemini_tuned_models_async_batch_embed_content Write write
integration__google_gemini__google_gemini_tuned_models_generate_content google-gemini.google_gemini_tuned_models_generate_content Write write
integration__google_gemini__google_gemini_tuned_models_transfer_ownership google-gemini.google_gemini_tuned_models_transfer_ownership Write write
integration__google_gemini__google_gemini_tuned_models_operations_list google-gemini.google_gemini_tuned_models_operations_list Read read
integration__google_gemini__google_gemini_tuned_models_operations_get google-gemini.google_gemini_tuned_models_operations_get Read read
integration__google_gemini__google_gemini_tuned_models_permissions_delete google-gemini.google_gemini_tuned_models_permissions_delete Write write
integration__google_gemini__google_gemini_tuned_models_permissions_list google-gemini.google_gemini_tuned_models_permissions_list Read read
integration__google_gemini__google_gemini_tuned_models_permissions_create google-gemini.google_gemini_tuned_models_permissions_create Write write
integration__google_gemini__google_gemini_tuned_models_permissions_get google-gemini.google_gemini_tuned_models_permissions_get Read read
integration__google_gemini__google_gemini_tuned_models_permissions_patch google-gemini.google_gemini_tuned_models_permissions_patch Write write
integration__google_gemini__google_gemini_models_generate_content google-gemini.google_gemini_models_generate_content Write write
integration__google_gemini__google_gemini_models_generate_message google-gemini.google_gemini_models_generate_message Write write
integration__google_gemini__google_gemini_models_predict google-gemini.google_gemini_models_predict Write write
integration__google_gemini__google_gemini_models_embed_content google-gemini.google_gemini_models_embed_content Write write
integration__google_gemini__google_gemini_models_list google-gemini.google_gemini_models_list Read read
integration__google_gemini__google_gemini_models_batch_embed_text google-gemini.google_gemini_models_batch_embed_text Write write
integration__google_gemini__google_gemini_models_async_batch_embed_content google-gemini.google_gemini_models_async_batch_embed_content Write write
integration__google_gemini__google_gemini_models_count_message_tokens google-gemini.google_gemini_models_count_message_tokens Write write
integration__google_gemini__google_gemini_models_count_tokens google-gemini.google_gemini_models_count_tokens Write write
integration__google_gemini__google_gemini_models_predict_long_running google-gemini.google_gemini_models_predict_long_running Write write
integration__google_gemini__google_gemini_models_generate_text google-gemini.google_gemini_models_generate_text Write write
integration__google_gemini__google_gemini_models_count_text_tokens google-gemini.google_gemini_models_count_text_tokens Write write
integration__google_gemini__google_gemini_models_embed_text google-gemini.google_gemini_models_embed_text Write write
integration__google_gemini__google_gemini_models_generate_answer google-gemini.google_gemini_models_generate_answer Write write
integration__google_gemini__google_gemini_models_batch_embed_contents google-gemini.google_gemini_models_batch_embed_contents Write write
integration__google_gemini__google_gemini_models_stream_generate_content google-gemini.google_gemini_models_stream_generate_content Write write
integration__google_gemini__google_gemini_models_batch_generate_content google-gemini.google_gemini_models_batch_generate_content Write write
integration__google_gemini__google_gemini_models_get google-gemini.google_gemini_models_get Read read
integration__google_gemini__google_gemini_models_operations_get google-gemini.google_gemini_models_operations_get Read read
integration__google_gemini__google_gemini_models_operations_list google-gemini.google_gemini_models_operations_list Read read
integration__google_gemini__google_gemini_generated_files_list google-gemini.google_gemini_generated_files_list Read read
integration__google_gemini__google_gemini_generated_files_operations_get google-gemini.google_gemini_generated_files_operations_get Read read

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.