Server definition
- Hash
- sha256:cc697798308bbe6cab59e9b6e75d59ea4b2462cd3b173484e4accc3896490131
- What it is
- What a remote MCP server returned when asked what it offers: 28 tools
The blob, as servednamed by its sha256
{
"instructions": "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. 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.",
"tools": [
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"conversion_id": {
"description": "The id of a conversion (cnv_...), from list_ad_conversions.",
"type": "string"
}
},
"required": [
"ad_id",
"conversion_id"
],
"type": "object"
},
"name": "approve_conversion",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "archive_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"amount_usd": {
"description": "Whole dollars (\"25\") or two decimals (\"25.00\").",
"pattern": "^[1-9][0-9]{0,8}(\\.[0-9]{2})?$",
"type": "string"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"idempotency_key": {
"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.",
"type": "string"
},
"payment_signature": {
"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.",
"type": "string"
}
},
"required": [
"amount_usd"
],
"type": "object"
},
"name": "buy_ad_credit",
"outputSchema": null
},
{
"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 one); otherwise use buy_ad_credit or create_ad, which create the account with the first payment.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"idempotency_key": {
"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.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "create_account",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"idempotency_key": {
"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.",
"type": "string"
},
"order": {
"properties": {
"ad_description": {
"type": "string"
},
"ad_title": {
"type": "string"
},
"bid_usd": {
"description": "Decimal string. Defaults to the minimum.",
"type": "string"
},
"daily_budget_usd": {
"type": "string"
},
"image_id": {
"type": "integer"
},
"landing_url": {
"description": "https only.",
"type": "string"
},
"name": {
"description": "Your name for the order.",
"type": "string"
},
"pricing_model": {
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
],
"type": "string"
},
"product": {
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats.",
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"type": "string"
},
"product_options": {
"type": "object"
},
"targeting": {
"type": "object"
},
"total_budget_usd": {
"description": "The most the ad can spend, and the price.",
"type": "string"
}
},
"required": [
"product",
"name",
"landing_url",
"ad_title"
],
"type": "object"
},
"payment_signature": {
"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.",
"type": "string"
}
},
"required": [
"order"
],
"type": "object"
},
"name": "create_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"label": {
"description": "Your name for the credential, 1 to 64 characters.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "create_event_credential",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"destination_template": {
"description": "The https landing URL of the ad, with {click_id} where the click id goes.",
"type": "string"
},
"draft_key": {
"description": "Only to add another test click to a draft_key you already hold.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "create_sandbox_click",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "end_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "get_ad",
"outputSchema": null
},
{
"description": "Delivery of one ad: totals and a daily series (impressions, clicks, visits, spend).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"days": {
"maximum": 90,
"minimum": 1,
"type": "integer"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "get_ad_stats",
"outputSchema": null
},
{
"description": "The account's balance in USD: available, reserved by ads in review or live, and total.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_balance",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"click_id": {
"description": "Only this sandbox click.",
"type": "string"
},
"draft_key": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "get_sandbox_verification",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "get_service_info",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"cursor": {
"description": "next_cursor of the page before, for the next page.",
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"status": {
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "list_ad_conversions",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"cursor": {
"description": "next_cursor of the page before, for the next page.",
"type": "string"
},
"disposition": {
"type": "string"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "list_ad_events",
"outputSchema": null
},
{
"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 rules and an example order with its price. Read this before building an order.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"required": [],
"type": "object"
},
"name": "list_ad_formats",
"outputSchema": null
},
{
"description": "The account's ads, newest first.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"before": {
"description": "Only ads with an id below this one.",
"minimum": 1,
"type": "integer"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"required": [],
"type": "object"
},
"name": "list_ads",
"outputSchema": null
},
{
"description": "Performance ads. The account's event-signing credentials: id, key_id, status and when each was last used. Never the secrets.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [],
"type": "object"
},
"name": "list_event_credentials",
"outputSchema": null
},
{
"description": "Pauses an active ad (Banner, Native, Paid Visits). Its budget stays reserved.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "pause_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"order": {
"properties": {
"ad_description": {
"type": "string"
},
"ad_title": {
"type": "string"
},
"bid_usd": {
"description": "Decimal string. Defaults to the minimum.",
"type": "string"
},
"daily_budget_usd": {
"type": "string"
},
"image_id": {
"type": "integer"
},
"landing_url": {
"description": "https only.",
"type": "string"
},
"name": {
"description": "Your name for the order.",
"type": "string"
},
"pricing_model": {
"enum": [
"CPC",
"CPM",
"CPA",
"REVSHARE",
"CPA_REVSHARE"
],
"type": "string"
},
"product": {
"description": "The ad format. Fields, limits and prices: GET /api/v1/formats.",
"enum": [
"PTC",
"Sponsored Listing",
"Banner",
"Native",
"Paid Visits",
"Performance"
],
"type": "string"
},
"product_options": {
"type": "object"
},
"targeting": {
"type": "object"
},
"total_budget_usd": {
"description": "The most the ad can spend, and the price.",
"type": "string"
}
},
"required": [
"product",
"name",
"landing_url",
"ad_title"
],
"type": "object"
}
},
"required": [
"order"
],
"type": "object"
},
"name": "quote_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"conversion_id": {
"description": "The id of a conversion (cnv_...), from list_ad_conversions.",
"type": "string"
},
"reject_code": {
"enum": [
"duplicate",
"fraud",
"bonus_abuse",
"chargeback",
"terms_violation",
"other"
],
"type": "string"
},
"reject_note": {
"type": "string"
}
},
"required": [
"ad_id",
"conversion_id",
"reject_code"
],
"type": "object"
},
"name": "reject_conversion",
"outputSchema": null
},
{
"description": "Resumes a paused ad: it serves again, within what is left of its budget.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
}
},
"required": [
"ad_id"
],
"type": "object"
},
"name": "resume_ad",
"outputSchema": null
},
{
"description": "Performance ads. Revokes a credential at once: events signed with it are refused from then on. It cannot be undone.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"credential_id": {
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials.",
"type": "string"
}
},
"required": [
"credential_id"
],
"type": "object"
},
"name": "revoke_event_credential",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"credential_id": {
"description": "The id of an event-signing credential (crd_...), from create_event_credential or list_event_credentials.",
"type": "string"
},
"grace_hours": {
"maximum": 168,
"minimum": 0,
"type": "integer"
}
},
"required": [
"credential_id"
],
"type": "object"
},
"name": "rotate_event_credential",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"amount_usd": {
"description": "Decimal string, for an event that carries an amount.",
"type": "string"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"click_id": {
"description": "The sandbox click id (tclk_...).",
"type": "string"
},
"customer_id": {
"description": "Your own id for the customer. Never an email address.",
"type": "string"
},
"event": {
"description": "The event name, for example signup or deposit: lower case letters, digits and underscores.",
"type": "string"
},
"event_id": {
"description": "A unique id for the event. Made for you when left out.",
"type": "string"
},
"goals": {
"description": "Goals of the order, to see which ones the event would complete.",
"type": "array"
},
"key_id": {
"description": "credential.key_id (bpk_...), to send a signed live event.",
"type": "string"
},
"occurred_at": {
"description": "RFC 3339, UTC.",
"type": "string"
},
"postback_token": {
"description": "The credential's postback token (advpb_...), to send the live event as a postback instead.",
"type": "string"
},
"properties": {
"description": "Flat values your goal rules filter on.",
"type": "object"
},
"signing_secret_hex": {
"description": "The credential's signing secret, with key_id.",
"type": "string"
}
},
"required": [
"click_id",
"event"
],
"type": "object"
},
"name": "send_sandbox_event",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"idempotency_key": {
"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.",
"type": "string"
},
"payment_signature": {
"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.",
"type": "string"
},
"reward_budget_usd": {
"description": "Decimal string with at most two decimals, before the fee.",
"type": "string"
}
},
"required": [
"ad_id",
"reward_budget_usd"
],
"type": "object"
},
"name": "top_up_ad",
"outputSchema": null
},
{
"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": {
"additionalProperties": false,
"properties": {
"ad_id": {
"description": "The id of an ad of this account.",
"minimum": 1,
"type": "integer"
},
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"changes": {
"description": "The order fields to change, as in list_ad_formats.",
"type": "object"
}
},
"required": [
"ad_id",
"changes"
],
"type": "object"
},
"name": "update_ad",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"api_key": {
"description": "The API key of the account (can_live_...). Optional when this MCP connection sends it as the Authorization: Bearer header.",
"type": "string"
},
"idempotency_key": {
"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.",
"type": "string"
},
"image_base64": {
"description": "The image file, base64-encoded: PNG, JPEG, WebP or GIF, at most 500 KB.",
"type": "string"
}
},
"required": [
"image_base64"
],
"type": "object"
},
"name": "upload_image",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:cc697798308bbe6cab59e9b6e75d59ea4b2462cd3b173484e4accc3896490131 | sha256sum