VoidnetVoid Docs
OpenapiV1 betaAdapterUsernameAppname

Send a request through the Voidnet

Proxy a JSON-RPC 2.0 request to the target Void App's publisher server. The gateway runs the request through its pipeline: authentication, rate limiting, billing, routing, circuit breaking, and protocol adaptation. The response body is the publisher's raw JSON-RPC response, passed through unchanged. The `Mcp-Session-Id` and `Mcp-Protocol-Version` headers are set on the response when the publisher returns them. Only the `mcp` adapter is currently available.

POST/v1-beta/{adapter}/{username}/{appname}

Proxy a JSON-RPC 2.0 request to the target Void App's publisher server. The gateway runs the request through its pipeline: authentication, rate limiting, billing, routing, circuit breaking, and protocol adaptation. The response body is the publisher's raw JSON-RPC response, passed through unchanged. The Mcp-Session-Id and Mcp-Protocol-Version headers are set on the response when the publisher returns them. Only the mcp adapter is currently available.

Path Parameters

adapter*string

Protocol adapter type (mcp)

username*string

Publisher username (the developer's public identifier)

appname*string

App name, unique per publisher

Header Parameters

Authorization*string

Bearer credential — API key (vnb-sk-* / vai-sk-*) or JWT access token

Request Body

application/json

JSON-RPC 2.0 request to proxy to the publisher

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1-beta/mcp/string/string" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{}'
{}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "status": 0
  }
}