> ## Documentation Index
> Fetch the complete documentation index at: https://docs.geekflare.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect Geekflare API to AI assistants and coding tools using the Model Context Protocol (MCP).

The Geekflare MCP server exposes all Geekflare API tools — web scraping, search, screenshots, DNS lookups, and more directly inside AI assistants and coding tools that support the [Model Context Protocol](https://modelcontextprotocol.io).

Once connected, you can ask your AI assistant to scrape a page, search the internet, or check DNS records without leaving your editor or chat interface.

## Connection Methods

<CardGroup cols={2}>
  <Card title="Remote URL" icon="globe">
    Point your client directly at the hosted MCP
    server. `https://mcp.geekflare.com/{API_KEY}/mcp`
  </Card>

  <Card title="Local via npx" icon="terminal">
    Run the MCP server locally using Node.js. No global install needed. `bash
            npx -y @geekflare/mcp `
  </Card>
</CardGroup>

## Available Tools

| Tool            | Description                                                        |
| --------------- | ------------------------------------------------------------------ |
| `webScrape`     | Scrape full page content — Markdown, HTML, JSON, or LLM-ready text |
| `metaScrape`    | Extract meta tags, Open Graph, and Twitter card data               |
| `screenshot`    | Capture full-page screenshots with ad blocking and CAPTCHA bypass  |
| `search`        | Web, news, and image search with optional AI-grounded answers      |
| `dnsRecord`     | Look up A, AAAA, CNAME, MX, TXT, and other DNS records             |
| `siteStatus`    | Check if a site is up or down from any location                    |
| `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                                          |
| `tlsScan`       | Inspect TLS/SSL configuration and certificate details              |
| `loadTime`      | Measure full page load time from any location                      |
| `ttfb`          | Measure Time To First Byte (TTFB)                                  |
| `httpHeader`    | Retrieve HTTP response headers                                     |
| `httpProtocol`  | Detect HTTP/1.1, HTTP/2, and HTTP/3 support                        |
| `mixedContent`  | Find HTTP resources loaded on HTTPS pages                          |
| `dnsSec`        | Check DNSSEC configuration                                         |
| `mtr`           | Run MTR network diagnostic tests                                   |
| `ping`          | Ping a host and return latency                                     |
| `lighthouse`    | Run Lighthouse audits for performance, SEO, and accessibility      |

## Client Guides

<CardGroup cols={2}>
  <Card title="Cursor" icon="arrow-pointer" href="/api/mcp/cursor" />

  <Card title="Claude Desktop" icon="robot" href="/api/mcp/claude-desktop" />

  <Card title="Claude Code" icon="terminal" href="/api/mcp/claude-code" />

  <Card title="Windsurf" icon="wind" href="/api/mcp/windsurf" />

  <Card title="VS Code" icon="code" href="/api/mcp/vscode" />

  <Card title="Cline" icon="brackets-curly" href="/api/mcp/cline" />

  <Card title="Roo Code" icon="kangaroo" href="/api/mcp/roo-code" />

  <Card title="Zed" icon="bolt" href="/api/mcp/zed" />

  <Card title="n8n" icon="diagram-project" href="/api/mcp/n8n" />

  <Card title="BoltAI" icon="bolt" href="/api/mcp/boltai" />

  <Card title="LM Studio" icon="brain" href="/api/mcp/lm-studio" />

  <Card title="Amazon Q" icon="amazon" href="/api/mcp/amazon-q" />

  <Card title="Others" icon="ellipsis" href="/api/mcp/others" />
</CardGroup>

## Test Your Connection

Use the official MCP Inspector to verify your server is running and tools are accessible.

**Option 1 — Remote server**

```bash theme={null}
npx @modelcontextprotocol/inspector https://mcp.geekflare.com/YOUR_API_KEY/mcp
```

**Option 2 — Local server**

```bash theme={null}
API_KEY=YOUR_API_KEY npx @modelcontextprotocol/inspector npx @geekflare/mcp
```

This opens a browser UI at `http://localhost:5173` where you can:

1. Click **Connect** to establish the connection
2. Go to the **Tools** tab to see all 20 available tools
3. Click any tool and run it with a test URL to verify it works

<Info>
  Replace `YOUR_API_KEY` with your Geekflare API key. Get one at
  [geekflare.com/api/](https://geekflare.com/api/).
</Info>

## Get Your API Key

<Card title="Get your API key" icon="key" href="https://auth.geekflare.com/register?service=geekflare_api">
  Sign up for a free account to generate your key.
</Card>