publish_x402_route
ActiveTool of Apiosk
declared in 1.7.0
Publish an API endpoint as a paid x402 route on the Apiosk gateway. The route gets a paid URL that returns 402 Payment Required until the caller pays in USDC, then forwards to your upstream API. New routes enter Apiosk's review queue (status pending_review) and go live on approval. Requires an Apiosk provider token (Authorization: Bearer sk_live_…).
Parameters schema
{
"type": "object",
"required": [
"name",
"upstream_url",
"price",
"settlement_address"
],
"properties": {
"name": {
"type": "string",
"description": "Human-readable API name, e.g. 'Weather API'."
},
"path": {
"type": "string",
"description": "Public path under the route's gateway slug, e.g. /weather. Defaults to the last segment of upstream_url."
},
"slug": {
"type": "string",
"description": "Optional gateway slug override (lowercase letters, numbers, hyphens). Defaults to a slug derived from name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": [
"string",
"number"
],
"description": "Price per call in USDC, e.g. \"0.01\"."
},
"method": {
"enum": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
],
"type": "string",
"description": "Defaults to GET."
},
"network": {
"enum": [
"base",
"polygon",
"arbitrum",
"solana"
],
"type": "string",
"description": "Settlement network. Defaults to base."
},
"currency": {
"enum": [
"USDC"
],
"type": "string",
"description": "Only USDC is supported."
},
"description": {
"type": "string"
},
"input_schema": {
"type": "object",
"additionalProperties": true
},
"upstream_url": {
"type": "string",
"description": "Full HTTPS URL of your existing endpoint the gateway forwards paid requests to."
},
"output_schema": {
"type": "object",
"additionalProperties": true
},
"settlement_address": {
"type": "string",
"description": "Wallet that receives 98% of each payment (Apiosk keeps a 2% platform fee)."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Apiosk
https://github.com/obcraft/apiosk-mcp
1/7 registries