Connect Linkup to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the web search tool in Linkup
Use the fetch webpage tool in Linkup
Use the check credit balance tool in Linkup
Use the get research tool in Linkup
Use the create research tool in Linkup
Use the list research tool in Linkup
Supported Tools
web_search
Web Search
Search the web using natural language queries and retrieve real-time content. Supports two depth modes: **standard** for fast results and **deep** for comprehensive iterative searching. Returns results in three formats: a natural language answer with sources, raw search result chunks for LLM grounding, or structured data following a custom JSON schema.
fetch_webpage
Fetch Webpage
Fetch a public webpage or PDF by URL and retrieve its content as clean markdown. Optionally include raw content, render JavaScript, extract images, or extract structured JSON data.
check_credit_balance
Check Credit Balance
Check the remaining credit balance on your Linkup account. Useful for monitoring API usage and ensuring sufficient credits before making search or fetch requests.
get_research
Get Research
Retrieve a research task and its current status, sourced answer or structured output, and any task failure. Get a task ID from create_research or list_research.
create_research
Create Research
Start an asynchronous web research task for a sourced report or structured JSON result. Returns a task ID; call get_research to retrieve status and the completed output.
list_research
List Research
List research tasks in the connected organization with IDs, status, inputs, completed outputs, and pagination metadata. Use get_research to check an individual task.
Enable Linkup in Metorial. In your Metorial portal, enable the Linkup MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Linkup tools.
Enable Linkup in Metorial. In your Metorial portal, enable the Linkup MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Linkup tools.
Enable Linkup in Metorial. In your Metorial portal, enable the Linkup MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Linkup tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Linkup in Metorial. In your Metorial portal, enable the Linkup MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Linkup tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Linkup in Metorial. In your Metorial portal, enable the Linkup MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Linkup tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Linkup through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Linkup and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Linkup tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Search and research the web with sourced answers or structured JSON, retrieve webpage and PDF content as markdown, extract images and page data, and monitor account credit balance.
Frequently asked questions
Common questions about connecting Linkup to AI agents with Metorial.
How many tools does the Linkup MCP server have?
The Linkup MCP server exposes 6 tools, including Web Search, Fetch Webpage, Check Credit Balance. Each one is governed and traced through Metorial.
Does the Linkup MCP server support triggers?
Linkup exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Linkup MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Linkup MCP server through the same Metorial URL.
How do I give only some teams access to Linkup?
Use role-based access control to decide which teams, users, and agents can use Linkup and which of its tools they can call.
Can I self-host the Linkup MCP server?
Yes. Metorial is open source, so you can run the Linkup MCP server yourself or use the hosted gateway.
Connect Linkup to production AI agents
See how Metorial gives your team governed access to Linkup, with tracing and security controls built in.