Overview

Quickstart

1
Install Toolport

Download Toolport for Windows, macOS or Linux. Installers and release notes are also on GitHub Releases. On Arch, use the pacman repository.

2
Add a server

Open Toolport and add a server in one of three ways:

  • From the catalog — pick a server and add it.
  • Import — pull in the servers a client already has configured.
  • Paste a config — drop in an existing MCP server JSON entry.
3
Authenticate it

Sign in with OAuth or paste an API key. Credentials go to your OS keychain, never into a client's config file.

4
Connect your AI clients

Open Clients, pick a client (Claude Desktop, Cursor, Codex, VS Code…) and click Connect to Toolport. Toolport writes a single toolport entry into that client's config and backs up the existing file first.

5
Restart the client

Start a new session so the client re-reads its config. The client row in Toolport changes to connected to Toolport.

With lazy discovery on (the default), the client sees four compact tools, toolport_status, toolport_search_tools, toolport_call_tool and toolport_fetch_result, instead of every downstream tool. Ask for something a server does and the agent searches, then calls.

VS Code may ask you to click Start Server on the toolport MCP entry the first time. That is VS Code's own MCP handling; after that it reconnects on its own.

Updated

Was this page helpful?