CryptoAd Network is an MCP server published by net.cryptoadvertising, hosted at cryptoadvertising.net. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 29 tools, including get_service_info, list_ad_formats, quote_ad, create_ad, buy_ad_credit.
Agent-native crypto ads: reach real crypto users from $0.05, paid in USDC via x402. No account.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
What this service is, whether payments are available, and on which networks a payment can be made (USDC, x402), with the smallest and largest payment.
No parameters.
{
"name": "get_service_info",
"title": "Service and payment info",
"description": "What this service is, whether payments are available, and on which networks a payment can be made (USDC, x402), with the smallest and largest payment.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Service and payment info",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}The catalog: every ad format (PTC, Sponsored Listing, Banner, Native, Paid Visits, Performance) with its fields, limits, pricing models, minimum bids, minimum order, image, video and HTML5 banner rules and an example order with its price. Read this before building an order.
No parameters.
{
"name": "list_ad_formats",
"title": "List ad formats and prices",
"description": "The catalog: every ad format (PTC, Sponsored Listing, Banner, Native, Paid Visits, Performance) with its fields, limits, pricing models, minimum bids, minimum order, image, video and HTML5 banner rules and an example order with its price. Read this before building an order.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "List ad formats and prices",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Validates an order and returns its exact price in USD with a breakdown. Creates nothing and costs nothing. An invalid order is answered with the code of the problem and the field it is in.
| Parameter | Type | Description |
|---|---|---|
| order * | object |
{
"name": "quote_ad",
"title": "Quote an ad order",
"description": "Validates an order and returns its exact price in USD with a breakdown. Creates nothing and costs nothing. An invalid order is answered with the code of the problem and the field it is in.",
"inputSchema": {
"type": "object",
"required": [
"order"
],
"properties": {
"order": {
"type": "object",
"required": [
"product",
"name",
"landing_url",
"ad_title"
],
"properties": {
"name": {
"type": "string",
"description": "Your name for the order."
},
"bid_usd": {
"type": "string",
"description": "Decimal string. Defaults to the minimum."
},
"product": {
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"type": "string",
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats."
},
"ad_title": {
"type": "string"
},
"image_id": {
"type": "integer"
},
"targeting": {
"type": "object"
},
"landing_url": {
"type": "string",
"description": "https only."
},
"pricing_model": {
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
],
"type": "string"
},
"ad_description": {
"type": "string"
},
"product_options": {
"type": "object"
},
"daily_budget_usd": {
"type": "string"
},
"total_budget_usd": {
"type": "string",
"description": "The most the ad can spend, and the price."
}
}
}
},
"additionalProperties": false
},
"annotations": {
"title": "Quote an ad order",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Places an ad order. With an API key whose balance covers the price, it is paid from the balance. Otherwise the result is isError with the x402 PaymentRequired object for the exact price: sign it and call this tool again with the same order and the payment (in _meta["x402/payment"], or as payment_signature). Without an API key the paid result carries api_key, the key of the new account that owns the ad: store it, it is shown once. The ad goes to review; poll get_ad. (The ad of an account the network has marked as trusted is active in this answer.)
| Parameter | Type | Description |
|---|---|---|
| order * | object | |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| idempotency_key | string | Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it. |
| payment_signature | string | The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta["x402/payment"] instead and leaves this out. |
{
"name": "create_ad",
"title": "Place an ad",
"description": "Places an ad order. With an API key whose balance covers the price, it is paid from the balance. Otherwise the result is isError with the x402 PaymentRequired object for the exact price: sign it and call this tool again with the same order and the payment (in _meta[\"x402/payment\"], or as payment_signature). Without an API key the paid result carries api_key, the key of the new account that owns the ad: store it, it is shown once. The ad goes to review; poll get_ad. (The ad of an account the network has marked as trusted is active in this answer.)",
"inputSchema": {
"type": "object",
"required": [
"order"
],
"properties": {
"order": {
"type": "object",
"required": [
"product",
"name",
"landing_url",
"ad_title"
],
"properties": {
"name": {
"type": "string",
"description": "Your name for the order."
},
"bid_usd": {
"type": "string",
"description": "Decimal string. Defaults to the minimum."
},
"product": {
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"type": "string",
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats."
},
"ad_title": {
"type": "string"
},
"image_id": {
"type": "integer"
},
"targeting": {
"type": "object"
},
"landing_url": {
"type": "string",
"description": "https only."
},
"pricing_model": {
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
],
"type": "string"
},
"ad_description": {
"type": "string"
},
"product_options": {
"type": "object"
},
"daily_budget_usd": {
"type": "string"
},
"total_budget_usd": {
"type": "string",
"description": "The most the ad can spend, and the price."
}
}
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"idempotency_key": {
"type": "string",
"description": "Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it."
},
"payment_signature": {
"type": "string",
"description": "The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta[\"x402/payment\"] instead and leaves this out."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Place an ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Buys prepaid ad credit at a fixed price: amount_usd in USDC, 1 USDC = $1.00 of credit (for example 1, 5, 10, 25, 50, 100). The first call returns isError with the x402 PaymentRequired object; call again with the signed payment. Without an API key the paid result carries api_key: the key of a new account whose balance is the credit, shown once. With an API key the credit is added to that account. Orders placed with the key are then paid from the balance, with no further payment.
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| amount_usd * | string | Whole dollars ("25") or two decimals ("25.00"). |
| idempotency_key | string | Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it. |
| payment_signature | string | The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta["x402/payment"] instead and leaves this out. |
{
"name": "buy_ad_credit",
"title": "Buy prepaid ad credit",
"description": "Buys prepaid ad credit at a fixed price: amount_usd in USDC, 1 USDC = $1.00 of credit (for example 1, 5, 10, 25, 50, 100). The first call returns isError with the x402 PaymentRequired object; call again with the signed payment. Without an API key the paid result carries api_key: the key of a new account whose balance is the credit, shown once. With an API key the credit is added to that account. Orders placed with the key are then paid from the balance, with no further payment.",
"inputSchema": {
"type": "object",
"required": [
"amount_usd"
],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"amount_usd": {
"type": "string",
"pattern": "^[1-9][0-9]{0,8}(\\.[0-9]{2})?$",
"description": "Whole dollars (\"25\") or two decimals (\"25.00\")."
},
"idempotency_key": {
"type": "string",
"description": "Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it."
},
"payment_signature": {
"type": "string",
"description": "The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta[\"x402/payment\"] instead and leaves this out."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Buy prepaid ad credit",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Creates an anonymous account with a zero balance and returns its API key, shown once. Only needed to upload an image before paying for anything (a Paid Visits ad needs an image or a video); otherwise use buy_ad_credit or create_ad, which create the account with the first payment. A video cannot be uploaded to an account made this way until it has been funded: for a video, start with buy_ad_credit.
| Parameter | Type | Description |
|---|---|---|
| idempotency_key | string | Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it. |
{
"name": "create_account",
"title": "Create an empty account",
"description": "Creates an anonymous account with a zero balance and returns its API key, shown once. Only needed to upload an image before paying for anything (a Paid Visits ad needs an image or a video); otherwise use buy_ad_credit or create_ad, which create the account with the first payment. A video cannot be uploaded to an account made this way until it has been funded: for a video, start with buy_ad_credit.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"idempotency_key": {
"type": "string",
"description": "Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create an empty account",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Stores an image for a Paid Visits ad (it needs an image or a video) or a Banner ad (optional; PNG, JPEG or GIF of exactly one banner size, see list_ad_formats) and returns its id, to send as image_id in the order. Needs an API key. A video for a Paid Visits ad is uploaded over HTTP instead: POST the file to /api/v1/videos, then follow it with get_video.
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| image_base64 * | string | The image file, base64-encoded: PNG, JPEG, WebP or GIF, at most 500 KB. |
| idempotency_key | string | Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it. |
{
"name": "upload_image",
"title": "Upload an ad image",
"description": "Stores an image for a Paid Visits ad (it needs an image or a video) or a Banner ad (optional; PNG, JPEG or GIF of exactly one banner size, see list_ad_formats) and returns its id, to send as image_id in the order. Needs an API key. A video for a Paid Visits ad is uploaded over HTTP instead: POST the file to /api/v1/videos, then follow it with get_video.",
"inputSchema": {
"type": "object",
"required": [
"image_base64"
],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"image_base64": {
"type": "string",
"description": "The image file, base64-encoded: PNG, JPEG, WebP or GIF, at most 500 KB."
},
"idempotency_key": {
"type": "string",
"description": "Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Upload an ad image",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}One video of the account: whether it is still processing, in_review or ready (both can be ordered as video_id of a Paid Visits ad), or failed or rejected, with the reason. A video is uploaded over HTTP, not through a tool: POST the file to /api/v1/videos (see list_ad_formats, video of Paid Visits).
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| video_id * | integer | The id an upload answered with. |
{
"name": "get_video",
"title": "Get a video",
"description": "One video of the account: whether it is still processing, in_review or ready (both can be ordered as video_id of a Paid Visits ad), or failed or rejected, with the reason. A video is uploaded over HTTP, not through a tool: POST the file to /api/v1/videos (see list_ad_formats, video of Paid Visits).",
"inputSchema": {
"type": "object",
"required": [
"video_id"
],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"video_id": {
"type": "integer",
"minimum": 1,
"description": "The id an upload answered with."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a video",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}One ad of the account: status (in_review, active, paused, rejected, completed, archived), spend, what remains, and the reason if it was rejected.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "get_ad",
"title": "Get an ad",
"description": "One ad of the account: status (in_review, active, paused, rejected, completed, archived), spend, what remains, and the reason if it was rejected.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get an ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}The account's ads, newest first.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| before | integer | Only ads with an id below this one. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "list_ads",
"title": "List ads",
"description": "The account's ads, newest first.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"before": {
"type": "integer",
"minimum": 1,
"description": "Only ads with an id below this one."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List ads",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Delivery of one ad: totals and a daily series (impressions, clicks, visits, spend).
| Parameter | Type | Description |
|---|---|---|
| days | integer | |
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "get_ad_stats",
"title": "Get the delivery of an ad",
"description": "Delivery of one ad: totals and a daily series (impressions, clicks, visits, spend).",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"days": {
"type": "integer",
"maximum": 90,
"minimum": 1
},
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get the delivery of an ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Pauses an active ad (Banner, Native, Paid Visits). Its budget stays reserved.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "pause_ad",
"title": "Pause an ad",
"description": "Pauses an active ad (Banner, Native, Paid Visits). Its budget stays reserved.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Pause an ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Resumes a paused ad: it serves again, within what is left of its budget.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "resume_ad",
"title": "Resume an ad",
"description": "Resumes a paused ad: it serves again, within what is left of its budget.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Resume an ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Ends an ad for good (Banner, Native, Paid Visits). What it has not spent returns to the balance. It cannot be started again.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "archive_ad",
"title": "End an ad",
"description": "Ends an ad for good (Banner, Native, Paid Visits). What it has not spent returns to the balance. It cannot be started again.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "End an ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}The account's balance in USD: available, reserved by ads in review or live, and total.
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "get_balance",
"title": "Get the balance",
"description": "The account's balance in USD: available, reserved by ads in review or live, and total.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get the balance",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Creates the credential your server signs its conversion events with, and returns credential.key_id (bpk_...), signing_secret_hex and postback_token. They are shown once: store them. The first step of a Performance ad.
| Parameter | Type | Description |
|---|---|---|
| label | string | Your name for the credential, 1 to 64 characters. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "create_event_credential",
"title": "Create an event-signing credential",
"description": "Performance ads. Creates the credential your server signs its conversion events with, and returns credential.key_id (bpk_...), signing_secret_hex and postback_token. They are shown once: store them. The first step of a Performance ad.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"label": {
"type": "string",
"description": "Your name for the credential, 1 to 64 characters."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create an event-signing credential",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Performance ads. The account's event-signing credentials: id, key_id, status and when each was last used. Never the secrets.
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "list_event_credentials",
"title": "List event-signing credentials",
"description": "Performance ads. The account's event-signing credentials: id, key_id, status and when each was last used. Never the secrets.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List event-signing credentials",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Replaces the secret and the postback token of a credential and returns the new ones, shown once. The old ones keep working for grace_hours (24 unless given, 0 to 168).
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| grace_hours | integer | |
| credential_id * | string | The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials. |
{
"name": "rotate_event_credential",
"title": "Rotate an event-signing credential",
"description": "Performance ads. Replaces the secret and the postback token of a credential and returns the new ones, shown once. The old ones keep working for grace_hours (24 unless given, 0 to 168).",
"inputSchema": {
"type": "object",
"required": [
"credential_id"
],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"grace_hours": {
"type": "integer",
"maximum": 168,
"minimum": 0
},
"credential_id": {
"type": "string",
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Rotate an event-signing credential",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Performance ads. Revokes a credential at once: events signed with it are refused from then on. It cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| credential_id * | string | The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials. |
{
"name": "revoke_event_credential",
"title": "Revoke an event-signing credential",
"description": "Performance ads. Revokes a credential at once: events signed with it are refused from then on. It cannot be undone.",
"inputSchema": {
"type": "object",
"required": [
"credential_id"
],
"properties": {
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"credential_id": {
"type": "string",
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Revoke an event-signing credential",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Performance ads. Mints a test click (click_id, tclk_...) and a draft_key, to prove the integration before an order. Give destination_template (your https landing URL with {click_id}) for a new ad, or ad_id to test an existing one. Then send one signed test event for the click (send_sandbox_event), and order with the draft_key in product_options.draft_key. A verified test event counts for one ad.
| Parameter | Type | Description |
|---|---|---|
| ad_id | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| draft_key | string | Only to add another test click to a draft_key you already hold. |
| destination_template | string | The https landing URL of the ad, with {click_id} where the click id goes. |
{
"name": "create_sandbox_click",
"title": "Create a sandbox test click",
"description": "Performance ads. Mints a test click (click_id, tclk_...) and a draft_key, to prove the integration before an order. Give destination_template (your https landing URL with {click_id}) for a new ad, or ad_id to test an existing one. Then send one signed test event for the click (send_sandbox_event), and order with the draft_key in product_options.draft_key. A verified test event counts for one ad.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"draft_key": {
"type": "string",
"description": "Only to add another test click to a draft_key you already hold."
},
"destination_template": {
"type": "string",
"description": "The https landing URL of the ad, with {click_id} where the click id goes."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create a sandbox test click",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Performance ads. With key_id and signing_secret_hex (or postback_token) of your credential, signs a test event for a sandbox click and sends it to the live event endpoint: verified true in the answer means the order will be accepted. Without credentials it only simulates the event against goals and verifies nothing. Costs nothing either way.
| Parameter | Type | Description |
|---|---|---|
| event * | string | The event name, for example signup or deposit: lower case letters, digits and underscores. |
| goals | array | Goals of the order, to see which ones the event would complete. |
| key_id | string | credential.key_id (bpk_...), to send a signed live event. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| click_id * | string | The sandbox click id (tclk_...). |
| event_id | string | A unique id for the event. Made for you when left out. |
| amount_usd | string | Decimal string, for an event that carries an amount. |
| properties | object | Flat values your goal rules filter on. |
| customer_id | string |
Performance ads. Whether a signed live test event has arrived for a draft_key (before the order) or for an ad: verified, when, by which transport, and the test events seen.
| Parameter | Type | Description |
|---|---|---|
| ad_id | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| click_id | string | Only this sandbox click. |
| draft_key | string |
{
"name": "get_sandbox_verification",
"title": "Get sandbox verification",
"description": "Performance ads. Whether a signed live test event has arrived for a draft_key (before the order) or for an ad: verified, when, by which transport, and the test events seen.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"click_id": {
"type": "string",
"description": "Only this sandbox click."
},
"draft_key": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get sandbox verification",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Changes an ad: changes takes the fields of an order that are to change (name, landing_url, ad_title, ad_description, targeting, product_options). An edit that changes what promoters are paid for goes to review again; the answer says so in edit.requires_review.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| changes * | object | The order fields to change, as in list_ad_formats. |
{
"name": "update_ad",
"title": "Update a Performance ad",
"description": "Performance ads. Changes an ad: changes takes the fields of an order that are to change (name, landing_url, ad_title, ad_description, targeting, product_options). An edit that changes what promoters are paid for goes to review again; the answer says so in edit.requires_review.",
"inputSchema": {
"type": "object",
"required": [
"ad_id",
"changes"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"changes": {
"type": "object",
"description": "The order fields to change, as in list_ad_formats."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Update a Performance ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Adds reward budget to an ad; the platform fee is added on top. Paid from the balance, or the result is isError with the x402 PaymentRequired object: sign it and call again with the same arguments, the returned idempotency_key and the payment.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| idempotency_key | string | Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it. |
| payment_signature | string | The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta["x402/payment"] instead and leaves this out. |
| reward_budget_usd * | string | Decimal string with at most two decimals, before the fee. |
{
"name": "top_up_ad",
"title": "Add reward budget to a Performance ad",
"description": "Performance ads. Adds reward budget to an ad; the platform fee is added on top. Paid from the balance, or the result is isError with the x402 PaymentRequired object: sign it and call again with the same arguments, the returned idempotency_key and the payment.",
"inputSchema": {
"type": "object",
"required": [
"ad_id",
"reward_budget_usd"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"idempotency_key": {
"type": "string",
"description": "Only to REPEAT an earlier call of this tool (a lost answer, a payment still confirming): the idempotency_key that call returned. Leave it out for a new call; the server then makes a random one and returns it."
},
"payment_signature": {
"type": "string",
"description": "The x402 PaymentPayload for the requirement an earlier call of this tool returned, as base64-encoded JSON (the value of an HTTP PAYMENT-SIGNATURE header). An x402-aware MCP client sends the payload in _meta[\"x402/payment\"] instead and leaves this out."
},
"reward_budget_usd": {
"type": "string",
"description": "Decimal string with at most two decimals, before the fee."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Add reward budget to a Performance ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Starts the wind-down of an ad: no new promoters, conversions already attributed are still paid, and what is not spent returns to the balance at the final settlement. It cannot be started again.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "end_ad",
"title": "End a Performance ad",
"description": "Performance ads. Starts the wind-down of an ad: no new promoters, conversions already attributed are still paid, and what is not spent returns to the balance at the final settlement. It cannot be started again.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "End a Performance ad",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Performance ads. Conversions and daily revenue-share accruals of an ad, newest first: goal, payout, status (held, approved, paid, rejected) and when a hold ends.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| limit | integer | |
| cursor | string | next_cursor of the page before, for the next page. |
| status | string | |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
{
"name": "list_ad_conversions",
"title": "List the conversions of a Performance ad",
"description": "Performance ads. Conversions and daily revenue-share accruals of an ad, newest first: goal, payout, status (held, approved, paid, rejected) and when a hold ends.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"description": "next_cursor of the page before, for the next page."
},
"status": {
"type": "string"
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
}
},
"additionalProperties": false
},
"annotations": {
"title": "List the conversions of a Performance ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. The events your server sent for an ad, newest first, each with what became of it: accepted, or dropped and why.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| limit | integer | |
| cursor | string | next_cursor of the page before, for the next page. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| disposition | string |
{
"name": "list_ad_events",
"title": "List the events of a Performance ad",
"description": "Performance ads. The events your server sent for an ad, newest first, each with what became of it: accepted, or dropped and why.",
"inputSchema": {
"type": "object",
"required": [
"ad_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"cursor": {
"type": "string",
"description": "next_cursor of the page before, for the next page."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"disposition": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"title": "List the events of a Performance ad",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Approves a conversion that is on hold before its hold ends, which releases its payout to the promoter. It cannot be undone.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| conversion_id * | string | The id of a conversion (cnv_...), from list_ad_conversions. |
{
"name": "approve_conversion",
"title": "Approve a held conversion",
"description": "Performance ads. Approves a conversion that is on hold before its hold ends, which releases its payout to the promoter. It cannot be undone.",
"inputSchema": {
"type": "object",
"required": [
"ad_id",
"conversion_id"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"conversion_id": {
"type": "string",
"description": "The id of a conversion (cnv_...), from list_ad_conversions."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Approve a held conversion",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Performance ads. Rejects a conversion while it is on hold: nothing is paid for it and its amount returns to the ad's budget. reject_code is one of duplicate, fraud, bonus_abuse, chargeback, terms_violation, other; other needs a reject_note of 10 to 500 characters.
| Parameter | Type | Description |
|---|---|---|
| ad_id * | integer | The id of an ad of this account. |
| api_key | string | The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header. |
| reject_code * | string | one of ["duplicate","fraud","bonus_abuse","chargeback","terms_violation","other"] |
| reject_note | string | |
| conversion_id * | string | The id of a conversion (cnv_...), from list_ad_conversions. |
{
"name": "reject_conversion",
"title": "Reject a held conversion",
"description": "Performance ads. Rejects a conversion while it is on hold: nothing is paid for it and its amount returns to the ad's budget. reject_code is one of duplicate, fraud, bonus_abuse, chargeback, terms_violation, other; other needs a reject_note of 10 to 500 characters.",
"inputSchema": {
"type": "object",
"required": [
"ad_id",
"conversion_id",
"reject_code"
],
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"reject_code": {
"enum": [
"duplicate",
"fraud",
"bonus_abuse",
"chargeback",
"terms_violation",
"other"
],
"type": "string"
},
"reject_note": {
"type": "string"
},
"conversion_id": {
"type": "string",
"description": "The id of a conversion (cnv_...), from list_ad_conversions."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Reject a held conversion",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}CryptoAd Network sells crypto advertising to AI agents: ads shown to real crypto users (paid-to-click, banner, native, paid visits, sponsored listings), from $0.05, with no account, email or browser. Flow: list_ad_formats, then quote_ad with an order, then create_ad with the same order. Payment is x402 (USDC). A tool that needs payment returns isError with the x402 PaymentRequired object; call the same tool again with the signed payment in _meta["x402/payment"] (or as the payment_signature argument). Nothing is created before the payment is confirmed on chain. The first paid call made without an API key returns api_key: store it and pass it as the api_key argument (or as the Authorization: Bearer header of this MCP connection) from then on. It is shown once. buy_ad_credit is the shortest way in: it sells prepaid ad credit at a fixed price and returns an API key holding it; orders are then paid from the balance. Every result of a call that can create something carries the idempotency_key it ran under. To repeat such a call (a lost answer, a payment still confirming), pass that value as idempotency_key. Every ad is reviewed before it goes live: poll get_ad until its status is active or rejected. An account the network has marked as trusted is not held for review: its ad is active in the answer of create_ad. A Paid Visits ad shows an image or a video. An image goes through upload_image (image_id). A video is a file too large for a tool call: POST it to /api/v1/videos over HTTP with the API key of an account that has been funded (buy_ad_credit first), follow it with get_video until its status is in_review or ready, then order with video_id. list_ad_formats has the limits. A Performance ad (pay per signup, deposit, wager or revenue share that your own server reports) needs an API key and one signed test event before the order: create_event_credential, then create_sandbox_click, then send_sandbox_event with click_id, event, key_id and signing_secret_hex, then create_ad with the sandbox click's draft_key in order.product_options.draft_key. A verified test event counts for one ad. After review, your server reports real events to the event endpoint that list_ad_formats names for Performance.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| Your own id for the customer. Never an email address. |
| occurred_at | string | RFC 3339, UTC. |
| postback_token | string | The credential's postback token (advpb_...), to send the live event as a postback instead. |
| signing_secret_hex | string | The credential's signing secret, with key_id. |
{
"name": "send_sandbox_event",
"title": "Send a sandbox test event",
"description": "Performance ads. With key_id and signing_secret_hex (or postback_token) of your credential, signs a test event for a sandbox click and sends it to the live event endpoint: verified true in the answer means the order will be accepted. Without credentials it only simulates the event against goals and verifies nothing. Costs nothing either way.",
"inputSchema": {
"type": "object",
"required": [
"click_id",
"event"
],
"properties": {
"event": {
"type": "string",
"description": "The event name, for example signup or deposit: lower case letters, digits and underscores."
},
"goals": {
"type": "array",
"description": "Goals of the order, to see which ones the event would complete."
},
"key_id": {
"type": "string",
"description": "credential.key_id (bpk_...), to send a signed live event."
},
"api_key": {
"type": "string",
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header."
},
"click_id": {
"type": "string",
"description": "The sandbox click id (tclk_...)."
},
"event_id": {
"type": "string",
"description": "A unique id for the event. Made for you when left out."
},
"amount_usd": {
"type": "string",
"description": "Decimal string, for an event that carries an amount."
},
"properties": {
"type": "object",
"description": "Flat values your goal rules filter on."
},
"customer_id": {
"type": "string",
"description": "Your own id for the customer. Never an email address."
},
"occurred_at": {
"type": "string",
"description": "RFC 3339, UTC."
},
"postback_token": {
"type": "string",
"description": "The credential's postback token (advpb_...), to send the live event as a postback instead."
},
"signing_secret_hex": {
"type": "string",
"description": "The credential's signing secret, with key_id."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Send a sandbox test event",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}