try_domain

Launch a memorable public URL for something you built. Free for 24 hours, no signup and no wallet required. Tell it your goal and an https target to point the address at; it opens a trial, asks a short safety question or two, and on a clean pass returns a live subdomain plus a one-time claim token you can redeem for your own agent identity. Use it to demo a deployment with a real address before a paid rental. One trial per agent. Expires in 24 hours.

Parameters9

goal	string	required	What you built and want to put online, in a sentence (used to name and describe the address).
target	string	optional	An https URL to point the address at. Content hosting is not yet available, so a live external target is required.
preferredSubdomain	string	optional	The subdomain label you want (e.g. 'mydemo'). Omit and set autoSelect:true to have one picked for you.
desiredEmotion	string	optional	Preferred vibe of the parent domain: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored.
autoSelect	boolean	optional	Let Popdot AI pick an available subdomain from your goal when you do not provide preferredSubdomain.
analyticsConsent	boolean	optional	Record operator consent to trial analytics for this address.
email	string	optional	Optional email to associate with the trial. Never returned.
trialHandle	string	optional	(retry only) The trialHandle returned by the first call. Echo it back with your answers.
inputResponses	array	optional	(retry only) Your answers to the safety questions, one { id, response } per requested input.

Raw schema

{
  "type": "object",
  "properties": {
    "goal": {
      "type": "string",
      "description": "What you built and want to put online, in a sentence (used to name and describe the address)."
    },
    "target": {
      "type": "string",
      "description": "An https URL to point the address at. Content hosting is not yet available, so a live external target is required."
    },
    "preferredSubdomain": {
      "type": "string",
      "description": "The subdomain label you want (e.g. 'mydemo'). Omit and set autoSelect:true to have one picked for you."
    },
    "desiredEmotion": {
      "type": "string",
      "enum": [
        "comedy",
        "absurd",
        "playful",
        "edgy",
        "wholesome",
        "professional",
        "trustworthy"
      ],
      "description": "Preferred vibe of the parent domain: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored."
    },
    "autoSelect": {
      "type": "boolean",
      "description": "Let Popdot AI pick an available subdomain from your goal when you do not provide preferredSubdomain."
    },
    "analyticsConsent": {
      "type": "boolean",
      "description": "Record operator consent to trial analytics for this address."
    },
    "email": {
      "type": "string",
      "description": "Optional email to associate with the trial. Never returned."
    },
    "trialHandle": {
      "type": "string",
      "description": "(retry only) The trialHandle returned by the first call. Echo it back with your answers."
    },
    "inputResponses": {
      "type": "array",
      "items": {
        "type": "object"
      },
      "description": "(retry only) Your answers to the safety questions, one { id, response } per requested input."
    }
  },
  "required": [
    "goal"
  ]
}

answer_trial_canary

Answer the short safety questions for a trial opened by try_domain, then go live. Pass the trialHandle and your answers; on a clean pass this provisions a live 24-hour subdomain and returns a one-time claim token you can redeem for your own agent identity.

Parameters2

trialHandle	string	required	The trialHandle returned by try_domain.
answers	array	required	Your answers to the safety questions, one { question_id, response } per question.

Raw schema

{
  "type": "object",
  "properties": {
    "trialHandle": {
      "type": "string",
      "description": "The trialHandle returned by try_domain."
    },
    "answers": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "question_id": {
            "type": "string"
          },
          "response": {
            "type": "string"
          }
        },
        "required": [
          "question_id",
          "response"
        ]
      },
      "description": "Your answers to the safety questions, one { question_id, response } per question."
    }
  },
  "required": [
    "trialHandle",
    "answers"
  ]
}

search_domains

Search domains available for rent on Popdot AI. Use this when an agent needs a web address: a verifiable web identity, a temporary deployment address, or a persistent web presence. Returns domains with pricing, tier, and availability. No auth required.

Parameters5

query	string	optional	Search query to match against domain names, tags, and categories
emotion	string	optional	Filter by the reaction the domain is built to elicit: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored.
minPrice	number	optional	Minimum daily price in USD
maxPrice	number	optional	Maximum daily price in USD
limit	number	optional	Maximum number of results to return (default: 20, max: 50)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query to match against domain names, tags, and categories"
    },
    "emotion": {
      "type": "string",
      "enum": [
        "comedy",
        "absurd",
        "playful",
        "edgy",
        "wholesome",
        "professional",
        "trustworthy"
      ],
      "description": "Filter by the reaction the domain is built to elicit: comedy, absurd, playful, edgy, wholesome, professional, trustworthy. Unknown values are ignored."
    },
    "minPrice": {
      "type": "number",
      "description": "Minimum daily price in USD"
    },
    "maxPrice": {
      "type": "number",
      "description": "Maximum daily price in USD"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of results to return (default: 20, max: 50)"
    }
  }
}

get_price_quote

Get a price quote for renting a specific domain for a given duration. Returns the computed rental cost, tier info, and pricing breakdown.

Parameters2

domainId	string	required	The unique ID of the domain to price
duration	string	required	ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)

Raw schema

{
  "type": "object",
  "properties": {
    "domainId": {
      "type": "string",
      "description": "The unique ID of the domain to price"
    },
    "duration": {
      "type": "string",
      "enum": [
        "PT1H",
        "PT4H",
        "P1D",
        "P7D",
        "P30D"
      ],
      "description": "ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)"
    }
  },
  "required": [
    "domainId",
    "duration"
  ]
}

check_availability

Check whether a specific subdomain is available on a given domain. Returns true if the subdomain can be rented. Tip: the subdomain and domain read as one phrase, so pick a single lowercase label that is funny or fits the domain's theme (for example iamyour.slopmommy.com or analien.lostmyluggage.com). A delightful combination is the point of a Popdot AI address.

Parameters2

domainId	string	required	The unique ID of the parent domain
subdomain	string	required	The subdomain label to check (e.g., 'myproject' for myproject.example.com)

Raw schema

{
  "type": "object",
  "properties": {
    "domainId": {
      "type": "string",
      "description": "The unique ID of the parent domain"
    },
    "subdomain": {
      "type": "string",
      "description": "The subdomain label to check (e.g., 'myproject' for myproject.example.com)"
    }
  },
  "required": [
    "domainId",
    "subdomain"
  ]
}

rent_domain

Rent a subdomain, paying per-transaction with USDC on Base (x402). No funded account or stored balance: each rental is a single on-chain payment. Requires agent authentication. Two phases: call once with intentMandateId, domainId, subdomain, duration, and the payerAddress + payerProof for the wallet you will pay from, to get the exact x402 payment challenge; pay it on Base; then call again with paymentId, txHash, and fromAddress to settle and receive the live rental plus a Web Identity Credential. Request an x402 payment challenge to rent a subdomain. Durations PT1H, PT4H, P1D, P7D, P30D. Returns the exact USDC amount and recipient on Base.

Parameters10

intentMandateId	string	required	The ID of the active Intent Mandate authorizing this purchase
domainId	string	required	The unique ID of the domain to rent on
subdomain	string	required	The subdomain label to rent (e.g., 'myproject' for myproject.example.com)
duration	string	required	ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)
payerAddress	string	optional	(phase 1) The 0x wallet you will pay from. Required on every challenge; a wallet registered on your Sigil does not substitute for it.
payerProof	string	optional	(phase 1) EIP-191 personal_sign signature proving control of payerAddress. Always required with payerAddress.
payerProofIssuedAt	string	optional	(phase 1, optional) ISO 8601 timestamp of the payerProof, within 5 minutes of the request.
paymentId	string	optional	(phase 2) The paymentId returned by the phase-1 challenge.
txHash	string	optional	(phase 2) The on-chain transaction hash of your USDC payment on Base.
fromAddress	string	optional	(phase 2) The wallet you paid from (must match the challenge's bound payer).

Raw schema

{
  "type": "object",
  "properties": {
    "intentMandateId": {
      "type": "string",
      "description": "The ID of the active Intent Mandate authorizing this purchase"
    },
    "domainId": {
      "type": "string",
      "description": "The unique ID of the domain to rent on"
    },
    "subdomain": {
      "type": "string",
      "description": "The subdomain label to rent (e.g., 'myproject' for myproject.example.com)"
    },
    "duration": {
      "type": "string",
      "enum": [
        "PT1H",
        "PT4H",
        "P1D",
        "P7D",
        "P30D"
      ],
      "description": "ISO 8601 duration: PT1H (1 hour), PT4H (4 hours), P1D (1 day), P7D (1 week), P30D (30 days)"
    },
    "payerAddress": {
      "type": "string",
      "description": "(phase 1) The 0x wallet you will pay from. Required on every challenge; a wallet registered on your Sigil does not substitute for it."
    },
    "payerProof": {
      "type": "string",
      "description": "(phase 1) EIP-191 personal_sign signature proving control of payerAddress. Always required with payerAddress."
    },
    "payerProofIssuedAt": {
      "type": "string",
      "description": "(phase 1, optional) ISO 8601 timestamp of the payerProof, within 5 minutes of the request."
    },
    "paymentId": {
      "type": "string",
      "description": "(phase 2) The paymentId returned by the phase-1 challenge."
    },
    "txHash": {
      "type": "string",
      "description": "(phase 2) The on-chain transaction hash of your USDC payment on Base."
    },
    "fromAddress": {
      "type": "string",
      "description": "(phase 2) The wallet you paid from (must match the challenge's bound payer)."
    }
  },
  "required": [
    "intentMandateId",
    "domainId",
    "subdomain",
    "duration"
  ]
}

upgrade_trial

Turn a free trial into your own paid, persistent address in one call, no human required. Redeem the one-time claimToken from try_domain with your BYO Ed25519 publicKey: this mints your unanchored agent identity (a Nascent Sigil) and, if you supply a wallet, returns the exact USDC-on-Base (x402) challenge to keep the trial's exact URL live on a paid rental. No wallet yet? You still get your identity plus an optional URL a human can use to sponsor the upgrade; fund a USDC wallet on Base later and pay it yourself.

Parameters7

claimToken	string	required	The one-time claim token returned by try_domain / answer_trial_canary.
publicKey	string	required	Your BYO Ed25519 public key. The minted identity is bound to it and you hold the private key.
duration	string	optional	Optional rental length: an ISO 8601 duration (PT1H, PT4H, P1D, P7D, P30D) or hourly/daily/weekly/monthly. Defaults to PT1H (1 hour).
payerAddress	string	optional	Optional 0x wallet you will pay from. Provide it (with payerProof) to receive a self-pay x402 challenge.
payerProof	string	optional	Optional EIP-191 personal_sign signature proving control of payerAddress.
payerProofIssuedAt	string	optional	Optional ISO 8601 timestamp of the payerProof, within 5 minutes.
requestSponsorUrl	boolean	optional	Set true to also receive an optional URL a human can use to sponsor the upgrade.

Raw schema

{
  "type": "object",
  "properties": {
    "claimToken": {
      "type": "string",
      "description": "The one-time claim token returned by try_domain / answer_trial_canary."
    },
    "publicKey": {
      "type": "string",
      "description": "Your BYO Ed25519 public key. The minted identity is bound to it and you hold the private key."
    },
    "duration": {
      "type": "string",
      "description": "Optional rental length: an ISO 8601 duration (PT1H, PT4H, P1D, P7D, P30D) or hourly/daily/weekly/monthly. Defaults to PT1H (1 hour)."
    },
    "payerAddress": {
      "type": "string",
      "description": "Optional 0x wallet you will pay from. Provide it (with payerProof) to receive a self-pay x402 challenge."
    },
    "payerProof": {
      "type": "string",
      "description": "Optional EIP-191 personal_sign signature proving control of payerAddress."
    },
    "payerProofIssuedAt": {
      "type": "string",
      "description": "Optional ISO 8601 timestamp of the payerProof, within 5 minutes."
    },
    "requestSponsorUrl": {
      "type": "boolean",
      "description": "Set true to also receive an optional URL a human can use to sponsor the upgrade."
    }
  },
  "required": [
    "claimToken",
    "publicKey"
  ]
}

Popdot AI

ai.popdot/popdot-mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

try_domain

answer_trial_canary

search_domains

get_price_quote

check_availability

rent_domain

upgrade_trial

popdot-mcp

Use

Docs

License

Install

Related servers