CryptoAd Network
Agent-native crypto ads: reach real crypto users from $0.05, paid in USDC via x402. No account.
使うべきか
品質と安全性
検出事項(2)
- LOWget_service_info 内
- LOWget_ad_stats 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"ads": {
"url": "https://cryptoadvertising.net/mcp"
}
}
}リモートエンドポイント
https://cryptoadvertising.net/mcpstreamable-httpできること
ツール一覧
ツール(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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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).
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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).
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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
}コミュニティ
エビデンス