Hardwire

Agentic actions. Without the clicks.

Turn a saved HTML form into an action contract. Check its inputs and approval rules, then generate an MCP tool description for your agent integration.

The goal is simple: applications should tell agents what they can do, what each action changes and which approval it needs. Hardwire provides the format and checks. Your application supplies the authorized handler.

Try the three actions · Watch the demo · Download · MCP Registry · Ask a question

One form. One command.

With Node 22 or newer, run the bundled email preference from the demo:

npx --yes --ignore-scripts --package=https://github.com/Automatron-workflows/hardwire/releases/download/v0.9.0/hardwire-0.9.0.tgz hardwire-form

Candidate action: preferences
Accepted: {"marketingEmails":false}
Rejected: {"marketingEmails":"false"}
MCP tool: preferences

Add --json to inspect the contract and generated tool. No app, account or API key is required. The command parses HTML locally and never calls its endpoint. Bring your own saved form.

See the same idea in three familiar actions

Open the visual experiment. Run an action, try invalid input and inspect the result if you want the details.

Scene	What you test
Sign in	A local session requires valid input and explicit consent.
Invoice	The exact €24 invoice requires owner approval; altered input is rejected.
Settings	A boolean changes a reversible preference; a string is rejected.

These use the real validator and fixed local JavaScript handlers. Google sign in is simulated and no money moves. The film illustrates the idea; it is not a speed benchmark. Run all three in your terminal.

Put it in an MCP client

Download the desktop bundle for a host that supports MCPB and Node 22 or newer. It includes the server and its runtime dependencies. No npm installation is needed to run the extracted bundle.

The server exposes five tools for inference, contract inspection, input checking, MCP description generation and trace verification. It operates on supplied data. It cannot browse files, connect accounts or execute the described application actions.

Desktop installation and verification · Other MCP clients and a first prompt

The bundle is tested through real MCP calls after extraction. Native host setup remains a separate verification task. GitHub packages and bundles are available; the npm name is not reserved. Do not install the unrelated unscoped npm package.

Add it to your project

Install the pinned release from GitHub:

npm install --ignore-scripts github:Automatron-workflows/hardwire#v0.9.0

Use the library on one known action, or use the guide’s MCP configuration to connect without cloning the repository.

Where it fits

You already have	Hardwire adds
An API or OpenAPI description	Explicit declared effects and approval floors to review alongside input types.
An MCP server	Contract checks before trusted handlers run. Generated descriptions remain data until you wire them in.
A saved HTML form	A candidate contract and testable input schema, ready for review.
Browser automation	A way to describe known operations when the application can expose them. No browser driver is included.

A panel describes an application's actions. A port is one action with an input schema, declared effect and confirmation requirement. A trace binds a caller's record to a panel revision. Digests check consistency; they do not prove identity, execution or approval. Read the format.

Experimental, with explicit limits

Inference cannot establish actual endpoint behavior, reversibility or permission. The benchmark has three synthetic fixtures, with scores of 100, 60 and 45; only one passes at 80. It does not establish accuracy on real websites. No general executor or WebMCP adapter is included. Evidence and next gates.

Bring one form

Run the experiment and share the first confusing step. Synthetic forms, reproducible bugs and verified client setups are useful small contributions.

Community welcome · Contributing · Support

If Hardwire is useful to you, star the repository to find it again.

Build and explore

git clone https://github.com/Automatron-workflows/hardwire.git
cd hardwire
npm ci --ignore-scripts
npm run check

API · Architecture · Integration · Security · Distribution · Launch status

MIT licensed. An Automatron project.

hardwire

Documentation