This release is a pre-release and may not be stable for production use.
node-wire-http
Generic HTTP connector for Node Wire. Lets an agent or app call any REST endpoint (GET, POST,
PUT, PATCH or DELETE) without a dedicated connector, while blocking requests to internal
network addresses.
Part of Node Wire. Every call runs through the Node Wire runtime, so it gets input validation, retries with a circuit breaker, scope policy, a shared error taxonomy, and OpenTelemetry tracing. A Node Wire host exposes each action over REST, gRPC and MCP.
Install
pip install node-wire-http
This pulls in node-wire-runtime. Pre-releases
are published as X.Y.ZbN; install one with pip install --pre node-wire-http. To install
every connector at once, use node-wire-connectors.
Wheels are compiled with Cython and contain no Python source. They are built for CPython 3.11, 3.12 and 3.13 on Linux x86_64 (manylinux and musllinux), macOS arm64 and Windows x64.
Actions
The connector registers as http_generic. MCP tool names are <connector_id>_<action>, with
dots replaced by underscores.
| Action | MCP tool | What it does |
|---|---|---|
request |
http_generic_request |
Sends one HTTP request (method, URL, query parameters, headers, body) and returns the status code, headers and body |
Configuration
Add the connector to config/connectors.yaml. It needs no credentials: the whole request is the
action payload.
connectors:
http_generic:
enabled: true
exposed_via: ["rest", "grpc", "mcp"]
| Variable | Purpose |
|---|---|
NW_HTTP_GENERIC_ALLOWED_HOSTS |
Optional. Comma- or space-separated hostnames; when set, requests to any other host are refused |
Usage
Set NW_ALLOWED_CONNECTORS=http_generic (comma-separate several). Node Wire loads only the
connectors listed there, and discovers them through the node_wire.connectors entry point.
A Node Wire host (the REST, gRPC or MCP server, or ConnectorFactory) then builds the connector
from the configuration above. See Use a connector.
Because this connector needs no credentials, you can also run it directly with only the PyPI packages installed:
import asyncio
import os
os.environ["NW_ALLOWED_CONNECTORS"] = "http_generic"
os.environ["NW_HTTP_GENERIC_ALLOWED_HOSTS"] = "httpbin.org"
from node_wire_runtime import get_connector_registry
from node_wire_runtime.connector_registry import auto_register
async def main() -> None:
auto_register()
connector = get_connector_registry()["http_generic"]()
response = await connector.run(
{"action": "request", "method": "GET", "url": "https://httpbin.org/get"}
)
print(response.success, response.data["status_code"])
asyncio.run(main())
Security notes
- Requests to loopback, private and link-local addresses and to cloud metadata endpoints are refused. The check runs when the payload is validated, and again against the resolved IP address at connection time.
NW_HTTP_GENERIC_ALLOWED_HOSTSnarrows egress to an explicit allowlist. Set it in production.- Logs omit query strings and URL fragments.
Documentation
- Node Wire on GitHub: source, issues and full documentation
- Connector reference
- Configuration
- Error codes
- Changelog
License
Apache-2.0. See LICENSE.
Metadata
Release files for node-wire-http 1.0.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
Total release size: 4.5 MB
Release files / node_wire_http-1.0.0b1-cp313-cp313-win_amd64.whl
| Download URL | node_wire_http-1.0.0b1-cp313-cp313-win_amd64.whl |
|---|---|
| Size | 99.1 kB |
| Tags | CPython 3.13 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
fc3bb1c7717eb3944b7bd37a65668ac83217ccebd5128caea69a4605ae444201
|
|
BLAKE2b-256 checksum How to use checksums |
290da0ba921d5b72ba1ddc55aeec1b900e4a0332257a4d1cdfacb3da5fb1c24b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp313-cp313-musllinux_1_2_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp313-cp313-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 637.5 kB |
| Tags | CPython 3.13 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
d949bba1a5c39855331066bae7cd83d80cd86d6e20d90c65afa8c14c2d3ad134
|
|
BLAKE2b-256 checksum How to use checksums |
cc0cab096c1dd9feab7d66ff773a988c9c8d2ef45364d0888b5fa01755155fd1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 639.8 kB |
| Tags | CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
c91b735368070df92c0743fd6cca359edad92989dcc83eee2ce65a89ba1c7cda
|
|
BLAKE2b-256 checksum How to use checksums |
eaac2b24ab0e980d9b4208f78227ae72f568bf695059f4f3d3296289c04b1a73
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp313-cp313-macosx_11_0_arm64.whl
| Download URL | node_wire_http-1.0.0b1-cp313-cp313-macosx_11_0_arm64.whl |
|---|---|
| Size | 111.3 kB |
| Tags | CPython 3.13 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
a6557827f437bee798d209a09109920e9002f6a93ada682612fa32158e65e8be
|
|
BLAKE2b-256 checksum How to use checksums |
0985a4bd9ed17a3e75f695240dc1f7e40e335714b3303144cde22e242c69499c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp312-cp312-win_amd64.whl
| Download URL | node_wire_http-1.0.0b1-cp312-cp312-win_amd64.whl |
|---|---|
| Size | 99.9 kB |
| Tags | CPython 3.12 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3034b1b8d197c48a40d954b507d02ccbf405184b1b88dd85d11ed50073da64f9
|
|
BLAKE2b-256 checksum How to use checksums |
d7c44afc4b3695c6cfcbff685ec786d007a7da1d3f111fb25bc29deb6e4e6d56
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp312-cp312-musllinux_1_2_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp312-cp312-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 658.3 kB |
| Tags | CPython 3.12 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
b076aad722d0f62bee54792dc468d8ceaf74f127bf36180a02ddc159e591d8e6
|
|
BLAKE2b-256 checksum How to use checksums |
6f289d0a66620e65b52c0c13a9775c37800950a890b74f56fa26ffbbf21df1f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 660.7 kB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
7cf29de83b3e12402a018c6fd73b0bed11da96cb1d97bb6ec40d2194e635ed61
|
|
BLAKE2b-256 checksum How to use checksums |
912f46859cce8c759ffeb59e9e17bc9ff96ea993fa97aa95eb5f82603d32fb10
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp312-cp312-macosx_11_0_arm64.whl
| Download URL | node_wire_http-1.0.0b1-cp312-cp312-macosx_11_0_arm64.whl |
|---|---|
| Size | 111.9 kB |
| Tags | CPython 3.12 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
530cbdc88b874a7043510433d94fde226b572106373b4a833158b862cd13c3b4
|
|
BLAKE2b-256 checksum How to use checksums |
35171003c7db24e41bb84aeb302abc157fac796f705d004c06d8144ce8b09038
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp311-cp311-win_amd64.whl
| Download URL | node_wire_http-1.0.0b1-cp311-cp311-win_amd64.whl |
|---|---|
| Size | 102.0 kB |
| Tags | CPython 3.11 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
6f0f16576edb53a99354cadd942f4f083f01ffda6c40bfa9891c53d62dd856a1
|
|
BLAKE2b-256 checksum How to use checksums |
0065133d8e86be7370832c3e4fb3af026d2dc33f952e1899be34f781f78b4e48
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp311-cp311-musllinux_1_2_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp311-cp311-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 635.2 kB |
| Tags | CPython 3.11 Linux musl 1.2+ x86-64 |
|
SHA-256 checksum How to use checksums |
3957db44ec76104747e11c35d6c39c284b5de8ac0000d3559a8ee00f79579f2c
|
|
BLAKE2b-256 checksum How to use checksums |
0f31863968b3d66e61b81ad9b406e9ba1a5a0bb757ec9d6873296a1f59f63fa8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | node_wire_http-1.0.0b1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 634.1 kB |
| Tags | CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 |
|
SHA-256 checksum How to use checksums |
a3aff064af99e3f734558d37f77709970e1ca222a2ef283654e20da8f6f7f115
|
|
BLAKE2b-256 checksum How to use checksums |
43f12360cd5ad5dc75508d316a723bf369fd54f91647aa0fc2679e21827a36ee
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency logRelease files / node_wire_http-1.0.0b1-cp311-cp311-macosx_11_0_arm64.whl
| Download URL | node_wire_http-1.0.0b1-cp311-cp311-macosx_11_0_arm64.whl |
|---|---|
| Size | 109.7 kB |
| Tags | CPython 3.11 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ad30d2c7c4f502752016b7db29e247853ac5c8fb8bb05ec51e6a5dccffd201e9
|
|
BLAKE2b-256 checksum How to use checksums |
3b219a0dba4e86b1de8d71d47a6e2a65844efef10437f9119a79f95ad9d93d8f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.9
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.
Transparency log
