Linkup MCP Server

Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

​

Features

• linkup-search: Real-time web search with natural language queries
  • Standard and deep search modes
  • Domain include/exclude lists, date range filters, max results, and optional image results
  • Access to current information from trusted sources
• linkup-research: Start autonomous, long-running research tasks
  • Multi-source investigation for questions a single search query cannot resolve
  • Synthesized, cited answers from the Research endpoint
  • Async workflow: start a task, then poll for completion
• linkup-get-research: Retrieve the status and result of a research task
  • Poll by task id until the task is completed or failed
  • Read completed answers from the task’s output field
• linkup-fetch: Fetch and extract content from any webpage
  • Optional JavaScript rendering for dynamic content
  • Optional image extraction and raw HTML output
  • Perfect for article extraction and content analysis

​

Remote MCP

​

Prerequisites

• A Linkup API key
• Any MCP client that supports remote MCP over HTTP

​

Authentication

Authorization: Bearer YOUR_API_KEY

​

Manual Configuration

• Cursor
• VS Code
• Codex

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "linkup": {
      "type": "http",
      "url": "https://mcp.linkup.so/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Add to your VS Code MCP config:

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

Add to ~/.codex/config.toml:

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

If you need to use the query parameter instead:

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

​

MCPB Bundle

​

What is MCPB?

​

Download

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

​

Installation

​

Local MCP

​

Prerequisites

• A Linkup API key
• Node.js (v24.0.0 or higher)

​

Configuration Examples

{
  "mcpServers": {
    "linkup": {
      "command": "npx",
      "args": ["-y", "linkup-mcp-server", "apiKey=YOUR_LINKUP_API_KEY"]
    }
  }
}

{
  "mcpServers": {
    "linkup": {
      "command": "npx",
      "args": ["-y", "linkup-mcp-server", "apiKey=YOUR_LINKUP_API_KEY"]
    }
  }
}

{
  "servers": {
    "linkup": {
      "command": "npx",
      "type": "stdio",
      "args": ["-y", "linkup-mcp-server", "apiKey=YOUR_LINKUP_API_KEY"]
    }
  }
}

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

​

Available tools

​

linkup-search

• query (required): Natural language search query. Full questions work best.
• depth (optional): Search depth - "standard" (default) or "deep"
  • "standard": For queries with direct answers leveraging agentic search (weather, stock prices, simple facts)
  • "deep": For complex research requiring analysis across multiple sources
  The Linkup API also supports a "fast" depth, but the MCP server only exposes "standard" and "deep". If you need "fast", call the API directly via the SDKs or the /search endpoint.
• includeImages (optional, default false): Return relevant images alongside text results, each with a URL and metadata.
• includeDomains (optional): Array of domains to restrict results to, e.g. ["bbc.com", "reuters.com"]. Max 100 domains.
• excludeDomains (optional): Array of domains to exclude from results, e.g. ["reddit.com", "quora.com"].
• fromDate (optional): Only include content published on or after this date. Format: YYYY-MM-DD.
• toDate (optional): Only include content published on or before this date. Format: YYYY-MM-DD.
• maxResults (optional): Maximum number of results to return (positive integer).

• “Search for the latest news about AI developments”
• “What’s the current weather in Tokyo?”
• “Find information about the new EU AI Act, only from bbc.com and reuters.com, published this year”

​

linkup-research

• query (required): Natural language research question. Detailed, full questions work best.
• mode (optional): Controls the type of investigation. Use "answer" for a precise, evidence-backed answer, "investigate" for a focused report on one subject, or "research" for a structured report across many topics. Omit it to let Linkup classify the question.
• reasoningDepth (optional): How much reasoning effort the task spends, trading latency for coverage. Use "S" for light coverage, "M" for balanced, "L" (default) for thorough, or "XL" for exhaustive.
• includeDomains (optional): Array of domains to restrict results to, e.g. ["bbc.com", "reuters.com"]. Recommended; max 100 domains.
• excludeDomains (optional): Array of domains to exclude from results, e.g. ["reddit.com", "quora.com"].
• fromDate (optional): Only include content published on or after this date. Format: YYYY-MM-DD.
• toDate (optional): Only include content published on or before this date. Format: YYYY-MM-DD.

• “Compare the 2024 cloud revenue growth of Microsoft, Amazon, and Google.”
• “Research the main regulatory differences between the EU AI Act and the US AI executive order.”
• “Investigate the current vendor landscape for enterprise browser security.”

​

linkup-get-research

• id (required): The research task id returned by linkup-research.

• Returns the task object with its status ("pending", "processing", "completed", or "failed").
• While the status is "pending" or "processing", keep polling every few seconds until a terminal state. Polling faster than once per second is rate-limited.
• When "completed", the result is in the output field. When "failed", the reason is in the error field.

​

linkup-fetch

• url (required): The URL to fetch content from
• renderJs (optional, default false): Whether to render JavaScript content.
  • Enable for dynamic pages that load content via JavaScript
  • Note: the request takes longer to complete
• extractImages (optional, default false): Extract images found on the page and return them in a dedicated images field. Useful when you need a list of all images for further processing or analysis.
• includeRawHtml (optional, default false): Include the page’s raw HTML in a dedicated rawHtml field. Useful for custom HTML parsing, preserving specific formatting, or accessing elements that might be filtered out during standard content extraction.

• “Fetch the content from https://example.com/article”
• “Get this blog post and summarize it: https://blog.example.com/post”
• “What are the events happening in Paris this week? Fetch the content from https://example.com/events”

​

Troubleshooting

​

Authentication Format

{
  "args": ["-y", "linkup-mcp-server", "apiKey=YOUR_API_KEY"]
}

{
  "env": {
    "LINKUP_API_KEY": "YOUR_API_KEY"
  }
}