Skip to main content

wingbox-http

Call the Wingbox code graph of a repository from another machine. wingbox-http serves the Wingbox MCP server over the Streamable HTTP transport of the Model Context Protocol: the same tools as wingbox mcp on stdio (impact, usages, build and the rest), at one URL.

Use it when the repository and its graph live on a build server, a dev container or a remote workstation, and the coding agent runs somewhere else.

Install

pip install "wingbox[http]"          # or: pipx install wingbox && pipx inject wingbox wingbox-http

The transport is a package of its own on purpose: wingbox itself holds no listening code. wingbox-http uses the Python standard library only, listens and answers, and opens no connection of its own.

Run

On the machine that holds the repository:

export WINGBOX_HTTP_TOKEN="$(openssl rand -hex 32)"     # keep it; clients send it
wingbox mcp --http --root /path/to/project --host 0.0.0.0 --port 8765 \
  --tls-cert fullchain.pem --tls-key privkey.pem

wingbox-http ... is the same command. The server answers at https://<host>:8765/mcp.

Option Meaning
--root DIR The repository to serve (default: the current directory)
--host ADDRESS Address to listen on (default 127.0.0.1). Any other address needs a token
--port N Port (default 8765)
--token-file FILE Read the token from the first line of FILE instead of WINGBOX_HTTP_TOKEN
--tls-cert FILE, --tls-key FILE Serve HTTPS with this certificate and key
--allow-origin ORIGIN Also accept browser requests from this origin; repeatable
--build-missing Build the code graph in the background when the repository has none

Without arguments the server listens on 127.0.0.1 only and asks for no token: that is for an SSH tunnel (ssh -L 8765:127.0.0.1:8765 host) or a reverse proxy that checks who calls.

Connect an agent

Claude Code:

claude mcp add --transport http wingbox https://host.example:8765/mcp \
  --header "Authorization: Bearer $WINGBOX_HTTP_TOKEN"

Codex:

codex mcp add wingbox --url https://host.example:8765/mcp --bearer-token-env-var WINGBOX_HTTP_TOKEN

Any other MCP client: the Streamable HTTP transport, URL https://host.example:8765/mcp, header Authorization: Bearer <token>.

What is exposed

Whoever holds the token can read the code graph of the repository (file names, symbols, dependencies, the lines Wingbox quotes) and start a build, which writes .wingbox/ in the repository. No tool reads a file outside the repository, runs a command you give it, or deletes anything.

  • The token is a shared secret of at least 32 characters, compared in constant time. It is taken from the environment or a file, never from the command line, and is never logged.
  • Listening on any address other than loopback is refused without a token.
  • Without --tls-cert and --tls-key the token travels unencrypted: use them, or put the port behind a TLS proxy or a private network.
  • A request with an Origin header that is not a loopback origin or one given with --allow-origin is answered 403, so a web page cannot call the server through the browser of someone on the same network.

Protocol

One endpoint, POST /mcp, for protocol revisions 2026-07-28 and 2025-11-25 down to 2024-11-05. Each request is answered with JSON; a tools/call that runs longer than a second is answered as an event stream, with a keep-alive line every ten seconds, when the client accepts one, so a long build is not cut by an idle timeout on the way. The server keeps no session and opens no stream of its own: GET and DELETE are answered 405. Calls run one after another, as on stdio.

License: MIT.

Metadata

Release files for wingbox-http 0.13.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wingbox-http 0.13.0
File Size Uploaded Provenance Actions
wingbox_http-0.13.0.tar.gz 11.0 kB Without provenance Details for wingbox_http-0.13.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for wingbox-http 0.13.0
File Interpreter ABI Platform Actions
wingbox_http-0.13.0-py3-none-any.whl Python 3 none any Details for wingbox_http-0.13.0-py3-none-any.whl

Total release size: 24.8 kB

Release files / wingbox_http-0.13.0.tar.gz

Download URL wingbox_http-0.13.0.tar.gz
Size 11.0 kB
Tags Source
SHA-256 checksum
How to use checksums
33026b207bc220ab7dd5adc0809d37af14ea94b3f63e66e0390d778f80c70b72
BLAKE2b-256 checksum
How to use checksums
e34658753c1412d8a3749a9eb4a2d44e8d3a500e02b7239382fd34cce17aece7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.6

Release files / wingbox_http-0.13.0-py3-none-any.whl

Download URL wingbox_http-0.13.0-py3-none-any.whl
Size 13.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
554f42a5d73ba0e6de9ae44e660158877cadf587987bad1aa50d654da5884c87
BLAKE2b-256 checksum
How to use checksums
011ea42c4857f418d0e1e39f6db7b052ff1adf0fd2152c9335f67b5a44bb496e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.6

Security for wingbox-http 0.13.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.13.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page