Xpersona

Crawler Summary

gemini-vision-mcp-server answer-first brief

MCP server for image analysis using Gemini 2.5 Pro through OpenRouter Gemini Vision MCP Server A Model Context Protocol (MCP) server that enables AI assistants like Claude and OpenCode to analyze images using Google's Gemini 2.5 Pro model through the OpenRouter API. About General-purpose developer tool for image analysis through AI. **No customer data, proprietary prompts, or core product logic.** Features - **Image Analysis**: Analyze images with detailed visual descriptions, object d Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Freshness

Last checked 2/22/2026

Best For

Contract is available with explicit auth and schema references.

Not Ideal For

gemini-vision-mcp-server is not ideal for teams that need stronger public trust telemetry, lower setup complexity, or more explicit contract coverage before production rollout.

Evidence Sources Checked

editorial-content, capability-contract, runtime-metrics, public facts pack

CardFactsSnapshotContractTrust
Claim this agent
Agent DossierGitHubSafety: 100/100

gemini-vision-mcp-server

MCP server for image analysis using Gemini 2.5 Pro through OpenRouter Gemini Vision MCP Server A Model Context Protocol (MCP) server that enables AI assistants like Claude and OpenCode to analyze images using Google's Gemini 2.5 Pro model through the OpenRouter API. About General-purpose developer tool for image analysis through AI. **No customer data, proprietary prompts, or core product logic.** Features - **Image Analysis**: Analyze images with detailed visual descriptions, object d

MCPverified

Public facts

6

Change events

1

Artifacts

0

Freshness

Feb 22, 2026

Verifiededitorial-content1 verified compatibility signal

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

Schema refs publishedTrust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 22, 2026

Vendor

Stanley Marketing

Artifacts

0

Benchmarks

0

Last release

1.0.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Published capability contract available. No trust telemetry is available yet. Last updated 2/24/2026.

View Source

Setup snapshot

git clone https://github.com/stanley-marketing/gemini-vision-mcp.git
  1. 1

    Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.

  2. 2

    Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content
Vendor (1)

Vendor

Stanley Marketing

profilemedium
Observed Feb 24, 2026Source linkProvenance
Compatibility (2)

Protocol compatibility

MCP

contracthigh
Observed Feb 24, 2026Source linkProvenance

Auth modes

mcp, api_key

contracthigh
Observed Feb 24, 2026Source linkProvenance
Artifact (1)

Machine-readable schemas

OpenAPI or schema references published

contracthigh
Observed Feb 24, 2026Source linkProvenance
Security (1)

Handshake status

UNKNOWN

trustmedium
Observed unknownSource linkProvenance
Integration (1)

Crawlable docs

6 indexed pages on the official domain

search_documentmedium
Observed Apr 15, 2026Source linkProvenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Docs Update

Docs refreshed: Sign in to GitHub · GitHub

search_documentmedium

Fresh crawlable documentation was indexed for the official domain.

Observed Apr 15, 2026

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

0

Examples

6

Snippets

0

Languages

typescript

Executable Examples

bash

npm install

bash

cp .env.example .env

env

OPENROUTER_API_KEY=your_actual_api_key_here

bash

npm run build

bash

npm run dev

bash

npm start

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

MCP server for image analysis using Gemini 2.5 Pro through OpenRouter Gemini Vision MCP Server A Model Context Protocol (MCP) server that enables AI assistants like Claude and OpenCode to analyze images using Google's Gemini 2.5 Pro model through the OpenRouter API. About General-purpose developer tool for image analysis through AI. **No customer data, proprietary prompts, or core product logic.** Features - **Image Analysis**: Analyze images with detailed visual descriptions, object d

Full README

Gemini Vision MCP Server

A Model Context Protocol (MCP) server that enables AI assistants like Claude and OpenCode to analyze images using Google's Gemini 2.5 Pro model through the OpenRouter API.

About

General-purpose developer tool for image analysis through AI. No customer data, proprietary prompts, or core product logic.

Features

  • Image Analysis: Analyze images with detailed visual descriptions, object detection, and text extraction
  • Multiple Formats: Supports JPG, PNG, GIF, WebP, and BMP image formats
  • Flexible Prompting: Ask specific questions about image content
  • Error Handling: Robust error handling with detailed logging
  • Type Safety: Full TypeScript implementation with comprehensive type definitions
  • Production Ready: Includes proper logging, validation, and configuration management

Prerequisites

  • Node.js 18.0.0 or higher
  • An OpenRouter API key (get one at openrouter.ai)

Installation

  1. Clone or download this repository

  2. Install dependencies:

    npm install

  3. Copy the environment template and configure your API key:

    cp .env.example .env

  4. Edit .env and add your OpenRouter API key:

    OPENROUTER_API_KEY=your_actual_api_key_here

Configure

Create .env from .env.example. Do not commit secrets.

  1. Build the project: 
    npm run build

Usage

Running the Server

For development:

npm run dev

For production:

npm start

MCP Client Configuration

To use this server with Claude Desktop or other MCP clients, add the following to your MCP configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "gemini-vision": {
      "command": "node",
      "args": ["/path/to/gemini-vision-mcp-server/dist/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

OpenCode: Add to your AGENTS.md file:

## MCP Servers

### Gemini Vision
- **Command**: `node /path/to/gemini-vision-mcp-server/dist/index.js`
- **Description**: Image analysis using Gemini 2.5 Pro
- **Environment**: `OPENROUTER_API_KEY=your_api_key_here`

Available Tools

analyze_image

Analyzes an image using Gemini 2.5 Pro and returns detailed insights.

Parameters:

  • imagePath (string, required): Absolute path to the image file
  • prompt (string, required): Question or instruction for analyzing the image

Example Usage:

{
  "name": "analyze_image",
  "arguments": {
    "imagePath": "/home/user/photos/vacation.jpg",
    "prompt": "Describe what you see in this image and identify any notable objects or people."
  }
}

Response Format:

{
  "analysis": "Detailed analysis of the image...",
  "model": "google/gemini-2.5-pro",
  "timestamp": "2024-01-15T10:30:00.000Z"
}

Example Prompts

Here are some effective prompts you can use:

  • General Description: "Describe what you see in this image in detail."
  • Object Detection: "List all the objects you can identify in this image."
  • Text Extraction: "Extract and transcribe any text visible in this image."
  • Scene Analysis: "What is the setting or location of this image?"
  • People Analysis: "Describe the people in this image, including their actions and expressions."
  • Technical Analysis: "Analyze the composition, lighting, and photographic techniques used."
  • Accessibility: "Provide an accessibility description for this image."

Configuration

Environment Variables

  • OPENROUTER_API_KEY (required): Your OpenRouter API key
  • LOG_LEVEL (optional): Logging level (debug, info, warn, error). Default: info
  • MAX_IMAGE_SIZE_MB (optional): Maximum image size in MB. Default: 10

Supported Image Formats

  • JPEG (.jpg, .jpeg)
  • PNG (.png)
  • GIF (.gif)
  • WebP (.webp)
  • BMP (.bmp)

Size Limits

  • Maximum image size: 10MB (configurable via MAX_IMAGE_SIZE_MB)
  • API timeout: 60 seconds

Development

Scripts

  • npm run build: Compile TypeScript to JavaScript
  • npm run dev: Run in development mode with hot reload
  • npm start: Run the compiled server
  • npm run lint: Run ESLint
  • npm run typecheck: Run TypeScript type checking

Project Structure

src/
├── index.ts              # Main server implementation
├── types/
│   └── index.ts          # TypeScript type definitions
├── utils/
│   ├── config.ts         # Configuration management
│   ├── logger.ts         # Logging utilities
│   └── image.ts          # Image processing utilities
└── services/
    └── openrouter.ts     # OpenRouter API service

Error Handling

The server includes comprehensive error handling for:

  • Invalid or missing API keys
  • Unsupported image formats
  • File not found errors
  • Image size limits
  • Network timeouts
  • API rate limits

All errors are logged with appropriate detail levels and returned to the client with helpful error messages.

Troubleshooting

Common Issues

  1. "Invalid OpenRouter API key"

    • Verify your API key is correct in the .env file
    • Ensure the environment variable is properly loaded

  2. "Image file not found"

    • Check that the image path is absolute and correct
    • Verify file permissions allow reading

  3. "Unsupported image format"

    • Ensure your image is in a supported format (JPG, PNG, GIF, WebP, BMP)

  4. "Image file too large"

    • Reduce image size or increase MAX_IMAGE_SIZE_MB limit

  5. "Rate limit exceeded"

    • Wait before making additional requests
    • Consider upgrading your OpenRouter plan

Debug Mode

Enable debug logging to see detailed information:

LOG_LEVEL=debug npm run dev

Safety & Privacy

Do not upload PII or confidential data. See SECURITY.md.

License

MIT. See LICENSE and NOTICE.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Run the test suite and linting
  6. Submit a pull request

Support

  • Create an issue on GitHub for bug reports or feature requests
  • Check the logs for detailed error information
  • Ensure your OpenRouter API key is valid and has sufficient credits

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

Verifiedcapability-contract

Endpoints

Dossier APISnapshot APIContract APITrust API

Contract coverage

Status

ready

Auth

mcp, api_key

Streaming

No

Data region

global

Protocol support

MCP: verified

Requires: mcp, lang:typescript

Forbidden: none

Guardrails

Operational confidence: medium

Contract is available with explicit auth and schema references.
Trust confidence is not low and verification freshness is acceptable.
Protocol support is explicitly confirmed in contract metadata.
Invocation examples
curl -s "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/snapshot"
curl -s "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract"
curl -s "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media
No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors
Gitlab Ai CatalogUpdated 1h agoRank 86

gitlab-mcp

A Model Context Protocol (MCP) server for GitLab

MCPAImcpmodel-context-protocol
Gitlab Public ProjectsUpdated 1h agoRank 83

gitlab-mcp

A Model Context Protocol (MCP) server for GitLab

MCPAImcpmodel-context-protocol
Zapier Agent TemplatesUpdated 1h agoRank 76

Viral Content Creation Agent

This agent researches trends, scripts videos, sets up engagement automation, and compiles everything into a shareable document.

MCPagentassistantautomation
Agent hubMore from this sourceMCP agents
Machine Appendix

Contract JSON

{
  "contractStatus": "ready",
  "authModes": [
    "mcp",
    "api_key"
  ],
  "requires": [
    "mcp",
    "lang:typescript"
  ],
  "forbidden": [],
  "supportsMcp": true,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": "https://github.com/stanley-marketing/gemini-vision-mcp#input",
  "outputSchemaRef": "https://github.com/stanley-marketing/gemini-vision-mcp#output",
  "dataRegion": "global",
  "contractUpdatedAt": "2026-02-24T19:46:35.298Z",
  "sourceUpdatedAt": "2026-02-24T19:46:35.298Z",
  "freshnessSeconds": 19550524
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/snapshot",
    "contractUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "trustUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/trust"
  },
  "curlExamples": [
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/snapshot\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract\"",
    "curl -s \"https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-10-09T02:28:40.270Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "supported",
      "confidenceSource": "contract",
      "notes": "Confirmed by capability contract"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "gemini",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "vision",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "image-analysis",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "openrouter",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|supported|contract capability:mcp|supported|profile capability:model-context-protocol|supported|profile capability:gemini|supported|profile capability:vision|supported|profile capability:image-analysis|supported|profile capability:openrouter|supported|profile"
}

Facts JSON

[
  {
    "factKey": "docs_crawl",
    "category": "integration",
    "label": "Crawlable docs",
    "value": "6 indexed pages on the official domain",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:35.298Z",
    "isPublic": true
  },
  {
    "factKey": "auth_modes",
    "category": "compatibility",
    "label": "Auth modes",
    "value": "mcp, api_key",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:35.298Z",
    "isPublic": true
  },
  {
    "factKey": "schema_refs",
    "category": "artifact",
    "label": "Machine-readable schemas",
    "value": "OpenAPI or schema references published",
    "href": "https://github.com/stanley-marketing/gemini-vision-mcp#input",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/contract",
    "sourceType": "contract",
    "confidence": "high",
    "observedAt": "2026-02-24T19:46:35.298Z",
    "isPublic": true
  },
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Stanley Marketing",
    "href": "https://github.com/stanley-marketing/gemini-vision-mcp#readme",
    "sourceUrl": "https://github.com/stanley-marketing/gemini-vision-mcp#readme",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-24T19:43:14.176Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/trust",
    "sourceUrl": "https://www.xpersona.co/api/v1/agents/mcp-stanley-marketing-gemini-vision-mcp/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "docs_update",
    "title": "Docs refreshed: Sign in to GitHub · GitHub",
    "description": "Fresh crawlable documentation was indexed for the official domain.",
    "href": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceUrl": "https://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fopenclaw%2Fskills%2Ftree%2Fmain%2Fskills%2Fasleep123%2Fcaldav-calendar",
    "sourceType": "search_document",
    "confidence": "medium",
    "observedAt": "2026-04-15T05:03:46.393Z",
    "isPublic": true
  }
]

Sponsored

Ads related to gemini-vision-mcp-server and adjacent AI workflows.