Linkup MCP Server

Linkup MCP Server

A Model Context Protocol (MCP) server that provides web search and page fetching capabilities through Linkup's advanced API. This server enables AI assistants like Claude to perform intelligent web searches with natural language queries and fetch content from any webpage, accessing real-time information from trusted sources across the web.

Features

• 🔍 Real-time Web Search: Search the web for current information, news, and data
• 🌐 Page Fetching: Fetch and extract content from any webpage
• 🎯 Natural Language Queries: Use full questions for best results
• 📊 Flexible Search Depth:
  • standard - For queries with direct answers
  • deep - For complex research requiring analysis across multiple sources
• 🖥️ JavaScript Rendering: Optional JS rendering for dynamic content
• ⚡ Fast: Powered by Linkup's optimized infrastructure

Installation

• Cursor, VSCode, Claude Code, Codex, or another MCP compatible client
• Linkup API key

Getting Your API Key

1. Create a Linkup account for free at app.linkup.so
2. Copy the API key from your dashboard

Remote MCP Server (recommended)

The hosted Linkup MCP server uses the Streamable HTTP transport. If your client supports remote HTTP MCP servers, you can reference the hosted endpoint directly.

If your client supports custom HTTP headers, prefer sending your API key in Authorization: Bearer LINKUP_API_KEY instead of putting it in the URL. The ?apiKey=... query parameter remains supported for clients that cannot send custom headers.

Cursor

In your ~/.cursor/mcp.json file, add the following:

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "type": "http",
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
    }
  }
}

VSCode

Add this to your VS Code MCP config file. See VS Code MCP docs for more info.

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY",
      "type": "http"
    }
  }
}

Codex

Codex supports both remote HTTP MCP servers and custom HTTP headers via config.toml.

Using a bearer token from the environment:

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp"
bearer_token_env_var = "LINKUP_API_KEY"
enabled = true

Or, if you prefer to keep using the query parameter:

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
enabled = true

MCP Bundle (recommended for Claude Desktop)

Download the pre-built MCP bundle, a self-contained package that works across compatible MCP clients such as Claude Desktop. MCP Bundles are developed by Anthropic. See the MCP Bundles repository for more information.

Quick Download:

curl -L -o linkup-mcp-server.mcpb https://github.com/LinkupPlatform/linkup-mcp-server/releases/latest/download/linkup-mcp-server.mcpb

Installation:

1. Download linkup-mcp-server.mcpb from releases (or use the curl command above)
2. Click on the file to install
3. Configure your API key when prompted

Local MCP Server

You can also run the MCP server locally over the stdio transport.

Cursor

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

VSCode

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

Codex

[mcp_servers.linkup]
command = "npx"
args = ["-y", "linkup-mcp-server", "apiKey=LINKUP_API_KEY"]
enabled = true

Usage

Once configured, you can ask your AI agent to search the web or fetch webpage content:

Search Examples:

• "Search the web for the latest news about AI developments"
• "What's the current weather in Tokyo?"
• "Find information about the new EU AI Act and how it affects startups"
• "Search for the latest stock price of NVIDIA"

Fetch Examples:

• "Fetch the content from https://example.com/article"
• "Get the content of this blog post: https://blog.example.com/post and make a summary of it"
• "Fetch https://example.com with JavaScript rendering enabled"

Search Depths

• Standard Search: Best for queries with direct answers (weather, stock prices, simple facts)
• Deep Search: Best for complex research requiring analysis across multiple sources (comprehensive guides, comparative analysis, in-depth research)

Tools Available

linkup-search

Search the web in real time using Linkup to retrieve current information, facts, and news from trusted sources.

Parameters:

• query (required): Natural language search query. Full questions work best.
• depth (optional): Search depth - "standard" (default) or "deep"

Use cases:

• Real-time data (weather, stocks, sports scores, events)
• Breaking news and current events
• Recent research and publications
• Product information and up-to-date prices
• Schedules and availability
• Any information not available in the AI's knowledge base

linkup-fetch

Fetch and extract content from any webpage URL.

Parameters:

• url (required): The URL to fetch content from.
• renderJs (optional): Whether to render JavaScript content (default: false). Enable this for dynamic pages that load content via JavaScript. Note: This makes the request slower.

Use cases:

• Retrieve page content for analysis or summarization
• Extract article content from news sites
• Get documentation from technical websites
• Fetch blog posts and written content

Development

Prerequisites

• Node.js >= 22.0.0
• npm

Setup

# Install dependencies
npm install

Running the HTTP Server

npm run dev

This starts the local Streamable HTTP server at http://localhost:2121/mcp.

Running with the stdio Transport

npm run build:stdio
npm run start:stdio -- apiKey=YOUR_API_KEY

For local development, you can also pass the key via environment variable:

LINKUP_API_KEY=YOUR_API_KEY npm run start:stdio

Testing with MCP Inspector

npm run build:stdio
npm run inspector -- apiKey=YOUR_API_KEY

This will open the MCP Inspector in your browser where you can test the search tool interactively.

License

MIT

Links

• Linkup Website
• Linkup Documentation
• Model Context Protocol

Support

If you have issues, contact us via email at support@linkup.so or join our Discord server.