Geekflare

@geekflare/mcp

Official MCP (Model Context Protocol) server for the Geekflare. Connect Geekflare's web intelligence tools directly to Claude, Cursor, Windsurf, and other AI assistants.

Setup

Get an API Key

Sign up at geekflare.com/api and copy your API key from the dashboard.

Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP settings:

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "geekflare": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY=your-api-key-here", "geekflare/mcp"]
    }
  }
}

Available Tools

webScrape

Scrape full page content from any URL. Returns HTML, Markdown, JSON, or LLM-optimised text — including structured data via ready-made extraction templates, custom CSS/XPath schemas, or AI-powered extraction.

metaScrape

Scrape meta tags — title, description, Open Graph, Twitter cards, and more.

brand

Get structured brand information for a website domain, including brand identity, logos, colors, typography, social profiles, links, page metadata, and company information.

The brand tool supports two levels of brand intelligence:

• standard — Returns structured brand information available from the website.
• enriched — Includes additional LLM-synthesized company intelligence when available.

Example

{
  "url": "https://example.com",
  "mode": "enriched"
}

To bypass cached data and fetch fresh information:

{
  "url": "https://example.com",
  "refresh": true,
  "mode": "enriched"
}

The response may include:

• Brand name, tagline, description, and slogan
• Logos and favicon
• Brand colors and palette
• Fonts and typography
• UI component styles and spacing
• Social profiles
• Important website links
• Page metadata and Open Graph information
• Company information such as industry, founded year, employee range, revenue range, company type, and target audience when available

Enriched company information depends on the publicly available information for the domain, so individual fields may be omitted.

screenshot

Capture a screenshot of any website. Supports full-page, element-only, Retina, dark mode, transparent backgrounds, and AI-friendly link highlighting.

search

Search the web and return clean, structured results. Supports web, news, and image search with optional AI-grounded answers.

dnsRecord

Look up DNS records for a domain.

Supported DNS record types:

A, AAAA, CNAME, MX, NS, SOA, TXT, CAA, SRV

siteStatus

Check if a site is up or down.

redirectCheck

Trace the full redirect chain of a URL.

brokenLink

Find all broken links on a webpage.

url2Pdf

Convert any URL to a downloadable PDF.

openPorts

Scan open ports on a host. Optionally perform service and version detection on ports found open.

Service Detection

Set detectServices: true to perform Nmap service/version detection on ports found open.

{
  "url": "example.com",
  "topPorts": 100,
  "detectServices": true
}

When successful, the response includes a services array containing information such as:

• Port number
• Port state
• Detected service name
• Product name
• Product version
• Additional service information
• Inferred OS type, when available

Example response structure:

{
  "data": [22, 80, 443],
  "services": [
    {
      "port": 22,
      "state": "open",
      "service": {
        "name": "ssh",
        "product": "OpenSSH",
        "version": "9.6"
      }
    },
    {
      "port": 443,
      "state": "open",
      "service": {
        "name": "https"
      }
    }
  ]
}

Service detection is best-effort and can take longer than a standard port scan.

If service detection is requested but cannot be completed, the API can return a servicesError field. The data field containing the discovered open ports remains available.

tlsScan

Inspect TLS/SSL configuration — protocols, ciphers, certificate details.

loadTime

Measure full page load time from any location. Optionally test reachability from multiple locations at once.

mixedContent

Detect mixed content issues (HTTP resources on HTTPS pages).

dnsSec

Check if DNSSEC is enabled and properly configured for a domain.

mtr

Run an MTR (My Traceroute) network diagnostic test.

ping

Ping a host and return latency.

lighthouse

Run a full Lighthouse audit — performance, SEO, accessibility, and best practices.

Environment Variables

Links

• API Documentation
• Geekflare API
• Report Issues

License

MIT