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/mcpThe 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-projectThe CLI prints the headers for the current login without putting the key in a command argument:
npx voidhash-cli auth token --project my-projectConfigure 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.