Toolport / Documentation / v0.4

Documentation

Connect your client. Inspect the tools. Understand every result.

Start with one authorized repository and one read-only request. The guides below take you from setup through precise tool inputs, permissions and recovery.

New to Toolport? Start here.

Follow the quickstart

Getting started

Understand the model, connect a client and make your first read-only request.

What is Toolport?

Understand the client, server and repository boundaries before you connect.

Quickstart

Connect a local MCP client, verify tool discovery and make one narrow request.

Your first request

Follow a question through its tool arguments, result and useful next call.

Results, limits and completeness

Distinguish an empty result from a partial result and avoid unsupported pagination.

Client setup

Configure the client you use and verify that it can discover Toolport.

Claude Code

Codex

Configure the command, forward credentials and inspect MCP discovery in Codex.

Cursor and JSON-based clients

Use an mcpServers entry and check runtime, token forwarding and tool approval.

Claude Desktop and VS Code

Understand the two configuration schemas and verify the local process.

Tool reference

Exact inputs, defaults, response shapes and limits for all four tools.

search_issues

Find issues in one repository using state, label and milestone filters.

get_issue

Read the description and metadata of one known issue.

list_labels

Discover exact label names before adding a search filter.

list_milestones

Discover milestone titles and states before narrowing an issue search.

Security & operations

Choose access deliberately and understand the boundaries of the connection.

Authentication and scope

Grant repository read access deliberately and keep tokens out of shared content.

Data flow and trust boundaries

Understand what reaches the client and which privacy claims need operator evidence.

Local execution and deployment

Understand stdio process ownership and the requirements for a real hosted service.

Disconnect and revoke access

Stop future client calls and end the underlying tracker authorization.

Troubleshooting

Diagnose startup, discovery, empty results and tool errors in a useful order.

The server will not connect

Separate process startup problems from credential and repository errors.

Tools do not appear

Verify initialization, tool enablement and the advertised schema.

Search returns no issues

Relax one filter at a time and verify exact repository metadata.

Error reference

Use the error code to choose a recovery step without exposing secrets.