CryptoAd Network
Agent-native crypto ads: reach real crypto users from $0.05, paid in USDC via x402. No account.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- LOWen get_service_info
- LOWen get_ad_stats
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"ads": {
"url": "https://cryptoadvertising.net/mcp"
}
}
}Puntos de conexión remotos
https://cryptoadvertising.net/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (28)
🟢get_service_info
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.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢list_ad_formats
The catalog: every ad format (PTC, Sponsored Listing, Banner, Native, Paid Visits, Performance) with its fields, limits, pricing models, minimum bids, minimum order, image rules and an example order with its price. Read this before building an order.
Esquema de entrada
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}🟢quote_ad(order)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"order": {
"type": "object",
"properties": {
"product": {
"type": "string",
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats."
},
"name": {
"type": "string",
"description": "Your name for the order."
},
"landing_url": {
"type": "string",
"description": "https only."
},
"ad_title": {
"type": "string"
},
"ad_description": {
"type": "string"
},
"pricing_model": {
"type": "string",
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
]
},
"bid_usd": {
"type": "string",
"description": "Decimal string. Defaults to the minimum."
},
"total_budget_usd": {
"type": "string",
"description": "The most the ad can spend, and the price."
},
"daily_budget_usd": {
"type": "string"
},
"targeting": {
"type": "object"
},
"product_options": {
"type": "object"
},
"image_id": {
"type": "integer"
}
},
"required": [
"product",
"name",
"landing_url",
"ad_title"
]
}
},
"required": [
"order"
],
"additionalProperties": false
}🟡create_ad(order, api_key, idempotency_key, payment_signature)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"order": {
"type": "object",
"properties": {
"product": {
"type": "string",
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats."
},
"name": {
"type": "string",
"description": "Your name for the order."
},
"landing_url": {
"type": "string",
"description": "https only."
},
"ad_title": {
"type": "string"
},
"ad_description": {
"type": "string"
},
"pricing_model": {
"type": "string",
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
]
},
"bid_usd": {
"type": "string",
"description": "Decimal string. Defaults to the minimum."
},
"total_budget_usd": {
"type": "string",
"description": "The most the ad can spend, and the price."
},
"daily_budget_usd": {
"type": "string"
},
"targeting": {
"type": "object"
},
"product_options": {
"type": "object"
},
"image_id": {
"type": "integer"
}
},
"required": [
"product",
"name",
"landing_url",
"ad_title"
]
},
"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."
}
},
"required": [
"order"
],
"additionalProperties": false
}⚪buy_ad_credit(amount_usd, api_key, idempotency_key, payment_signature)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"amount_usd": {
"type": "string",
"pattern": "^[1-9][0-9]{0,8}(\\.[0-9]{2})?$",
"description": "Whole dollars (\"25\") or two decimals (\"25.00\")."
},
"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."
}
},
"required": [
"amount_usd"
],
"additionalProperties": false
}🟡create_account(idempotency_key)
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 one); otherwise use buy_ad_credit or create_ad, which create the account with the first payment.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}🟡upload_image(image_base64, api_key, idempotency_key)
Stores an image for a Paid Visits ad (required there) 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.
Esquema de entrada
{
"type": "object",
"properties": {
"image_base64": {
"type": "string",
"description": "The image file, base64-encoded: PNG, JPEG, WebP or GIF, at most 500 KB."
},
"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."
}
},
"required": [
"image_base64"
],
"additionalProperties": false
}🟢get_ad(ad_id, api_key)
One ad of the account: status (in_review, active, paused, rejected, completed, archived), spend, what remains, and the reason if it was rejected.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🟢list_ads(limit, before, api_key)
The account's ads, newest first.
Esquema de entrada
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"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."
}
},
"required": [],
"additionalProperties": false
}🟢get_ad_stats(ad_id, days, api_key)
Delivery of one ad: totals and a daily series (impressions, clicks, visits, spend).
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 90
},
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}⚪pause_ad(ad_id, api_key)
Pauses an active ad (Banner, Native, Paid Visits). Its budget stays reserved.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}⚪resume_ad(ad_id, api_key)
Resumes a paused ad: it serves again, within what is left of its budget.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🔴archive_ad(ad_id, api_key)
Ends an ad for good (Banner, Native, Paid Visits). What it has not spent returns to the balance. It cannot be started again.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🟢get_balance(api_key)
The account's balance in USD: available, reserved by ads in review or live, and total.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}🟡create_event_credential(label, api_key)
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.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}🟢list_event_credentials(api_key)
Performance ads. The account's event-signing credentials: id, key_id, status and when each was last used. Never the secrets.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [],
"additionalProperties": false
}⚪rotate_event_credential(credential_id, grace_hours, api_key)
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).
Esquema de entrada
{
"type": "object",
"properties": {
"credential_id": {
"type": "string",
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials."
},
"grace_hours": {
"type": "integer",
"minimum": 0,
"maximum": 168
},
"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."
}
},
"required": [
"credential_id"
],
"additionalProperties": false
}🔴revoke_event_credential(credential_id, api_key)
Performance ads. Revokes a credential at once: events signed with it are refused from then on. It cannot be undone.
Esquema de entrada
{
"type": "object",
"properties": {
"credential_id": {
"type": "string",
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials."
},
"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."
}
},
"required": [
"credential_id"
],
"additionalProperties": false
}🟡create_sandbox_click(destination_template, draft_key, ad_id, api_key)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"destination_template": {
"type": "string",
"description": "The https landing URL of the ad, with {click_id} where the click id goes."
},
"draft_key": {
"type": "string",
"description": "Only to add another test click to a draft_key you already hold."
},
"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."
}
},
"required": [],
"additionalProperties": false
}🟡send_sandbox_event(click_id, event, customer_id, event_id, amount_usd, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"click_id": {
"type": "string",
"description": "The sandbox click id (tclk_...)."
},
"event": {
"type": "string",
"description": "The event name, for example signup or deposit: lower case letters, digits and underscores."
},
"customer_id": {
"type": "string",
"description": "Your own id for the customer. Never an email address."
},
"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."
},
"occurred_at": {
"type": "string",
"description": "RFC 3339, UTC."
},
"properties": {
"type": "object",
"description": "Flat values your goal rules filter on."
},
"key_id": {
"type": "string",
"description": "credential.key_id (bpk_...), to send a signed live event."
},
"signing_secret_hex": {
"type": "string",
"description": "The credential's signing secret, with key_id."
},
"postback_token": {
"type": "string",
"description": "The credential's postback token (advpb_...), to send the live event as a postback instead."
},
"goals": {
"type": "array",
"description": "Goals of the order, to see which ones the event would complete."
},
"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."
}
},
"required": [
"click_id",
"event"
],
"additionalProperties": false
}🟢get_sandbox_verification(draft_key, ad_id, click_id, api_key)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"draft_key": {
"type": "string"
},
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"click_id": {
"type": "string",
"description": "Only this sandbox click."
},
"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."
}
},
"required": [],
"additionalProperties": false
}🟡update_ad(ad_id, changes, api_key)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"changes": {
"type": "object",
"description": "The order fields to change, as in list_ad_formats."
},
"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."
}
},
"required": [
"ad_id",
"changes"
],
"additionalProperties": false
}⚪top_up_ad(ad_id, reward_budget_usd, api_key, idempotency_key, payment_signature)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"reward_budget_usd": {
"type": "string",
"description": "Decimal string with at most two decimals, before the fee."
},
"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."
}
},
"required": [
"ad_id",
"reward_budget_usd"
],
"additionalProperties": false
}🔴end_ad(ad_id, api_key)
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.
Esquema de entrada
{
"type": "object",
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🟢list_ad_conversions(ad_id, status, cursor, limit, api_key)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"status": {
"type": "string"
},
"cursor": {
"type": "string",
"description": "next_cursor of the page before, for the next page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}🟢list_ad_events(ad_id, disposition, cursor, limit, api_key)
Performance ads. The events your server sent for an ad, newest first, each with what became of it: accepted, or dropped and why.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"disposition": {
"type": "string"
},
"cursor": {
"type": "string",
"description": "next_cursor of the page before, for the next page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"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."
}
},
"required": [
"ad_id"
],
"additionalProperties": false
}⚪approve_conversion(ad_id, conversion_id, api_key)
Performance ads. Approves a conversion that is on hold before its hold ends, which releases its payout to the promoter. It cannot be undone.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"conversion_id": {
"type": "string",
"description": "The id of a conversion (cnv_...), from list_ad_conversions."
},
"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."
}
},
"required": [
"ad_id",
"conversion_id"
],
"additionalProperties": false
}⚪reject_conversion(ad_id, conversion_id, reject_code, reject_note, api_key)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"ad_id": {
"type": "integer",
"minimum": 1,
"description": "The id of an ad of this account."
},
"conversion_id": {
"type": "string",
"description": "The id of a conversion (cnv_...), from list_ad_conversions."
},
"reject_code": {
"type": "string",
"enum": [
"duplicate",
"fraud",
"bonus_abuse",
"chargeback",
"terms_violation",
"other"
]
},
"reject_note": {
"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."
}
},
"required": [
"ad_id",
"conversion_id",
"reject_code"
],
"additionalProperties": false
}Comunidad
Evidencia