gemini-url-context

name	gemini-url-context
description	Expand and analyze URLs using Google Gemini 2.5 Flash URL Context API. Efficiently fetches, summarizes, and extracts information from up to 20 URLs per request with grounding metadata and source citations. Use when analysing or summarising specific URLs using Gemini's 1M-token context window.
version	1.0.0
author	agentbox-claude
mcp_server	true
protocol	fastmcp
entry_point	mcp-server/server.py
dependencies	["httpx"]
env_vars	["GOOGLE_GEMINI_API_KEY"]

Gemini URL Context Skill

Leverage Google's Gemini 2.5 Flash model to expand, summarize, and analyze web content directly from URLs.

When to Use This Skill

• URL Expansion: Fetch and summarize content from any URL
• Multi-URL Analysis: Compare or synthesize content from up to 20 URLs
• Document Extraction: Extract structured data from web pages
• Research Aggregation: Gather information from multiple sources
• Content Grounding: Get AI responses grounded in specific web sources

When Not To Use

• For YouTube video transcript extraction -- use the web-summary skill instead (Gemini does not support YouTube)
• For broad web search across many sources -- use the perplexity-research skill instead
• For browser automation, form filling, or interactive page navigation -- use the browser or playwright skills instead
• For summarising content you already have as text -- no URL expansion tool is needed; process it directly
• For pages behind paywalls or requiring authentication -- Gemini URL Context cannot access restricted content

Architecture

┌─────────────────────────────────┐
│  Claude Code / Skill Invocation │
└──────────────┬──────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────┐
│  Gemini URL Context MCP Server  │
│  (FastMCP - Python)             │
└──────────────┬──────────────────┘
               │ HTTPS REST API
               ▼
┌─────────────────────────────────┐
│  Google Gemini 2.5 Flash API    │
│  (with url_context tool)        │
└─────────────────────────────────┘

Tools

Tool	Description
expand_url	Expand and summarize a single URL
expand_urls	Batch expand multiple URLs (up to 20)
compare_urls	Compare content from 2+ URLs
extract_from_url	Extract specific data from URL content
health_check	Verify API connectivity

Examples

# Expand a single URL
expand_url({
    "url": "https://example.com/article",
    : 
})


expand_urls({
    : [
        ,
        
    ],
    : 
})


compare_urls({
    : [
        ,
        
    ],
    : 
})


extract_from_url({
    : ,
    : {
        : ,
        : ,
        : 
    }
})