MCP server

Connect an AI coding agent to your Voidhash paywall workspace.

The Voidhash MCP server lets compatible coding agents inspect and edit paywalls, write components, and render previews.

Server

https://api.voidhash.com/api/mcp

The server uses streamable HTTP and bearer authentication.

Create credentials

For a single project, use a project secret key and keep it out of source control:

Authorization: Bearer vh_sk_...

For a user key that can access multiple projects, also send the project ID or slug:

Authorization: Bearer vh_...
X-Voidhash-Project: my-project

The CLI prints the headers for the current login without putting the key in a command argument:

npx voidhash-cli auth token --project my-project

Configure your client

Add a remote or streamable HTTP MCP server named voidhash, then set the URL and headers above. Clients that use JSON configuration commonly accept this shape:

{
  "mcpServers": {
    "voidhash": {
      "type": "http",
      "url": "https://api.voidhash.com/api/mcp",
      "headers": {
        "Authorization": "Bearer vh_sk_..."
      }
    }
  }
}

Configuration keys differ between clients. Use your client's remote MCP instructions when it expects servers instead of mcpServers, or serverUrl instead of url.

Verify the connection

Ask the agent:

What paywalls do I have in Voidhash?

It should call list_paywalls and return the current project's paywalls. If it receives 401, replace the key. If a user key can authenticate but no project is selected, add X-Voidhash-Project.

Treat MCP credentials as secrets

The MCP server can modify project content. Prefer a project-scoped key, store it in your client's secret storage, and rotate it when a device or configuration is shared.