AgentDomains

Official19 toolsLive

by tashfeenahmed · TypeScript

Free domains under makes.fyi or agentdomains.co for the sites and APIs AI agents build.

Agent Domains MCP Server

This MCP server provides access to free domains under makes.fyi or agentdomains.co for sites and APIs that AI agents build. It is identified as io.github.tashfeenahmed/agentdomains-mcp (slug: io-github-tashfeenahmed-agentdomains-mcp). The server description emphasizes domain availability for agent-created applications.

🛠️ Key Features

Supplies free domains under makes.fyi and agentdomains.co
Targets domains for sites and APIs built by AI agents

🚀 Use Cases

Assigning or selecting domains for agent-built web sites
Configuring domains for agent-built APIs

⚡ Developer Benefits

Reusable domain source for projects using agent-created sites and APIs
Clear scoping to makes.fyi and agentdomains.co namespace

⚠️ Limitations

No additional capabilities (tools, endpoints, authentication, or protocols beyond the MCP server context) are specified in the provided data

Topics

agentdomainsai-agentsclaude-codecloudflarednsfree-subdomainmcpmcp-servermodel-context-protocolremote-mcpsubdomain

Captured live from the server via tools/list.

check_availability

Check whether a subdomain label is free before claiming it. Requires no API key. Returns { label, domain, fqdn, available, reason } where reason is 'available', 'taken', or 'invalid' (with a 'detail' explaining why the label is not usable).

Parameters2

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label"
  ]
}

signup

Create a new AgentDomains account and get an API key. Requires no existing key. IMPORTANT: the returned api_key is shown ONCE and is never retrievable again — you must store it immediately (save it to ~/.agentdomains/config.json or set AGENTDOMAINS_API_KEY) or the account is lost. The account is provisional: attach and confirm an email within 30 days (see the attach_email tool) or it is deleted along with its domains. This endpoint is rate-limited per IP address.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

whoami

Show the current account: id, state, attached email and whether it is verified, domains used, and which domains are available to claim under. When quotas are disabled the response omits 'quota' and says unlimited:true; 'max_subdomains' is the separate hard cap on how many names one account may hold at once (10 on the free plan, 100 on Pro). 'plan' is 'free' or 'pro'; when Pro is on sale a free account also gets an 'upgrade' hint (see upgrade_to_pro).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

attach_email

Attach an email address to the account and send it a verification link. A human must click that link within 30 days or the provisional account and its domains are deleted. Use this right after signup.

Parameters1

string

required

The email address to attach and send the verification link to.

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address to attach and send the verification link to."
    }
  },
  "required": [
    "email"
  ]
}

claim_domain

Register a subdomain (label.makes.fyi or label.agentdomains.co) on this account, optionally creating its first DNS record in the same call. An email is required the first time an account registers a name — pass 'email' here or call attach_email first; the name is reaped if that email is not confirmed within 30 days. Returns the fqdn and, when a record was requested, the created record. The claim and its first record succeed or fail together: if the record is malformed (400) or the provider refuses it (503) the label is NOT claimed, so fix the record and call again. Re-claiming a name this account already holds answers 409 with owned:true — that means carry on using it, not pick another label.

Parameters6

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.
email	string	optional	Required on the account's first registration if no email is attached yet. Sends a confirmation link.
type	string	optional	Optional DNS record to create immediately: A, AAAA, CNAME, or TXT.
content	string	optional	Value for that record (an IP for A/AAAA, a hostname for CNAME, text for TXT).
host	string	optional	Optional extra sub-label for the record (e.g. 'www' gives www.myapp.makes.fyi).

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    },
    "email": {
      "type": "string",
      "description": "Required on the account's first registration if no email is attached yet. Sends a confirmation link."
    },
    "type": {
      "type": "string",
      "description": "Optional DNS record to create immediately: A, AAAA, CNAME, or TXT."
    },
    "content": {
      "type": "string",
      "description": "Value for that record (an IP for A/AAAA, a hostname for CNAME, text for TXT)."
    },
    "host": {
      "type": "string",
      "description": "Optional extra sub-label for the record (e.g. 'www' gives www.myapp.makes.fyi)."
    }
  },
  "required": [
    "label"
  ]
}

list_domains

List every subdomain on this account, with each one's DNS records and whether it is forwarding, proxying, or delegated to external nameservers.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

get_domain

Show one subdomain in full: its fqdn, DNS records, forward or proxy configuration, and delegation state.

Parameters2

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label"
  ]
}

delete_domain

DESTRUCTIVE AND IRREVERSIBLE: permanently delete a subdomain and every DNS record, forward, and proxy attached to it. The hostname stops resolving immediately and the label is released for anyone else to claim. There is no undo and no recovery. Only call this when the user has explicitly asked for this specific name to be deleted.

Parameters2

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label"
  ]
}

add_dns_record

Add a DNS record to a subdomain you already own. Use type A or AAAA to point at an IP address, CNAME to point at another hostname, or TXT for verification strings. Adding a record does not replace existing ones; use delete_record to remove a single one. Refused with a 409 while the label carries a forward or a proxy (they own the hostname) — call remove_forward or remove_proxy first, or add the record on a sub-label via 'host', which is a different hostname and unaffected.

Parameters5

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
type	string	required	Record type: A, AAAA, CNAME, or TXT.
content	string	required	Record value: an IP for A/AAAA, a hostname for CNAME, the string for TXT.
host	string	optional	Optional extra sub-label under the name (e.g. 'www' creates www.myapp.makes.fyi). Omit for the name itself.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "type": {
      "type": "string",
      "description": "Record type: A, AAAA, CNAME, or TXT."
    },
    "content": {
      "type": "string",
      "description": "Record value: an IP for A/AAAA, a hostname for CNAME, the string for TXT."
    },
    "host": {
      "type": "string",
      "description": "Optional extra sub-label under the name (e.g. 'www' creates www.myapp.makes.fyi). Omit for the name itself."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "type",
    "content"
  ]
}

delete_record

DESTRUCTIVE: permanently remove ONE DNS record from a subdomain, keeping the name and every other record. Use this to undo a single record — a wrong IP, a spent ACME challenge — instead of delete_domain, which takes the whole name. The record_id is the 'id' field shown by get_domain (and returned by claim_domain and add_dns_record); it is not the record's name or content. The hostname stops resolving through that record immediately and there is no undo.

Parameters3

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
record_id	string	required	The record's 'id' as reported by get_domain — not its name, type, or content.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "record_id": {
      "type": "string",
      "description": "The record's 'id' as reported by get_domain — not its name, type, or content."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "record_id"
  ]
}

add_acme_challenge

Publish a Let's Encrypt DNS-01 challenge: creates a TXT record at _acme-challenge.<label>.<domain> with the token your ACME client printed. Use this to get a certificate without exposing port 80 (for example for a wildcard cert, or a host behind NAT). DNS propagates within seconds, then tell your ACME client to continue. For a normal public web server, HTTP-01 validation needs no DNS record at all.

Parameters3

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
value	string	required	The challenge token from your ACME client, published verbatim as the TXT value.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "value": {
      "type": "string",
      "description": "The challenge token from your ACME client, published verbatim as the TXT value."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "value"
  ]
}

set_forward

Forward (HTTP-redirect) a subdomain to another URL. Claims the label first if you do not own it yet, in which case an email may be required exactly as for claim_domain. Defaults to a 302 temporary redirect that preserves the request path and query. HTTPS at the edge is handled for you. A forward TAKES OVER the hostname: any A/AAAA/CNAME record on the label itself is deleted as part of this call and returned in 'replaced_records' — report those to the user, since the name no longer points where it did. Records on a sub-label (www.myapp.makes.fyi) and TXT records are untouched. If the forward fails to come up the replaced records are restored, with new ids.

Parameters7

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
target	string	required	Destination URL, including scheme (e.g. https://example.com/docs).
permanent	boolean	optional	Use a 301 permanent redirect instead of the default 302 temporary one.
preserve_path	boolean	optional	Append the incoming path and query to the target. Defaults to true; set false to always land on the target root.
cloak	boolean	optional	Keep the AgentDomains hostname in the address bar and load the target inside a frame. Discouraged — breaks many sites.
email	string	optional	Email, if this call also claims a new name on an account without one.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "target": {
      "type": "string",
      "description": "Destination URL, including scheme (e.g. https://example.com/docs)."
    },
    "permanent": {
      "type": "boolean",
      "description": "Use a 301 permanent redirect instead of the default 302 temporary one."
    },
    "preserve_path": {
      "type": "boolean",
      "description": "Append the incoming path and query to the target. Defaults to true; set false to always land on the target root."
    },
    "cloak": {
      "type": "boolean",
      "description": "Keep the AgentDomains hostname in the address bar and load the target inside a frame. Discouraged — breaks many sites."
    },
    "email": {
      "type": "string",
      "description": "Email, if this call also claims a new name on an account without one."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "target"
  ]
}

remove_forward

Stop forwarding a subdomain. The name itself stays registered on the account; only the redirect is removed.

Parameters2

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label"
  ]
}

set_proxy

Serve a backend at this subdomain through the AgentDomains edge, which terminates TLS with its own certificate — this is how you get working HTTPS on an origin that has no certificate of its own (a bare IP-less PaaS host, a tunnel, an internal box). Unlike a forward, the URL stays on your domain and the response is proxied, not redirected. Claims the label first if needed. Like a forward, a proxy TAKES OVER the hostname: A/AAAA/CNAME records on the label itself are deleted and returned in 'replaced_records', while sub-label and TXT records are untouched. A proxy and a forward are mutually exclusive on one label. Caveat: apps that hardcode their own hostname (OAuth callbacks especially) may need your new hostname registered on their side.

Parameters4

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
origin	string	required	Backend hostname to proxy to, without a scheme (e.g. myapp.fly.dev). Must be a hostname, not an IP.
email	string	optional	Email, if this call also claims a new name on an account without one.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "origin": {
      "type": "string",
      "description": "Backend hostname to proxy to, without a scheme (e.g. myapp.fly.dev). Must be a hostname, not an IP."
    },
    "email": {
      "type": "string",
      "description": "Email, if this call also claims a new name on an account without one."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "origin"
  ]
}

remove_proxy

Stop reverse-proxying a subdomain, so the edge no longer serves the backend or terminates TLS for it. The name stays registered on the account.

Parameters2

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label"
  ]
}

delegate_nameservers

Delegate the subdomain to your own nameservers, handing you full control of it and everything beneath it (your own records, MX, deeper sub-domains). AgentDomains stops answering for the name, so its existing records, forwards, and proxies no longer apply. Supply at least two nameservers.

Parameters3

label	string	required	The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi).
nameservers	array	required	Your nameserver hostnames, e.g. ['ns1.yourdns.com', 'ns2.yourdns.com']. At least two.
domain	string	optional	Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default.

Raw schema

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "description": "The subdomain label, without the domain suffix (e.g. 'myapp' for myapp.makes.fyi)."
    },
    "nameservers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Your nameserver hostnames, e.g. ['ns1.yourdns.com', 'ns2.yourdns.com']. At least two."
    },
    "domain": {
      "type": "string",
      "description": "Which domain to act under: 'makes.fyi' (the default) or 'agentdomains.co'. The same label can exist under each, so pass this whenever you are not using the default."
    }
  },
  "required": [
    "label",
    "nameservers"
  ]
}

delete_account

DESTRUCTIVE AND IRREVERSIBLE, AND THE LARGEST ONE HERE: delete the whole AgentDomains account and invalidate its API key, which cannot be recovered or reissued — every later tool call fails with a 401 until a new signup. Without force it REFUSES while the account still holds names, answering 409 with the list of them; that refusal is a safety net, so show the list to the user and get an explicit yes before retrying. With force:true those names are deleted too: they stop resolving at once and are released for anyone else to claim. Only ever call this when the user has asked to close the account itself — never as cleanup after a task, and never to 'start fresh' on your own initiative.

Parameters1

force

boolean

optional

Delete the names the account still holds along with it. Without this the call is refused while any name remains, which is the intended default.

Raw schema

{
  "type": "object",
  "properties": {
    "force": {
      "type": "boolean",
      "description": "Delete the names the account still holds along with it. Without this the call is refused while any name remains, which is the intended default."
    }
  }
}

upgrade_to_pro

Get a Stripe checkout link for AgentDomains Pro: 100 names instead of the free 10, names never released for being unreachable, and priority email support, for $5/month (or $48/year with interval 'year'). Use this when a claim is refused because the account is at its name limit and the user wants more. It only returns a link and never charges anything: a human must open the URL and pay. Show them the url and say what Pro costs; do not open it or pay on their behalf. If the account is already Pro the answer has kind:'portal' and a link to manage the subscription instead. Answers 404 'billing is not enabled' on a server that does not sell Pro.

Parameters1

interval

string

optional

Billing interval: 'month' ($5, the default) or 'year' ($48).

Raw schema

{
  "type": "object",
  "properties": {
    "interval": {
      "type": "string",
      "enum": [
        "month",
        "year"
      ],
      "description": "Billing interval: 'month' ($5, the default) or 'year' ($48)."
    }
  }
}

manage_billing

Get a Stripe billing-portal link for a Pro account: update the card, see invoices, switch between monthly and yearly, or cancel. A human must open it. Cancelling keeps Pro to the end of the paid period and never deletes a name. Answers 409 if the account has never subscribed (use upgrade_to_pro).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

README.md8 KBView on GitHub

AgentDomains MCP server

MCP server for AgentDomains — free domains for the websites and APIs AI agents build. It gives any MCP-speaking agent a real hostname under makes.fyi or agentdomains.co, with DNS records, HTTPS, URL forwarding, and reverse proxying.

Two ways to run it: locally over stdio via npx, or against the hosted remote endpoint at https://mcp.agentdomains.co.

Install (stdio)

No install step — npx fetches it on demand:

bash

AGENTDOMAINS_API_KEY=adom_… npx -y agentdomains-mcp

Claude Code

bash

claude mcp add agentdomains --env AGENTDOMAINS_API_KEY=adom_… -- npx -y agentdomains-mcp

Claude Desktop and other config-file clients

Add to claude_desktop_config.json (or your client's equivalent):

json

{
  "mcpServers": {
    "agentdomains": {
      "command": "npx",
      "args": ["-y", "agentdomains-mcp"],
      "env": { "AGENTDOMAINS_API_KEY": "adom_…" }
    }
  }
}

Remote endpoint

code

https://mcp.agentdomains.co

Streamable HTTP; send JSON-RPC over POST with your key in the Authorization header:

bash

curl -s https://mcp.agentdomains.co \
  -H 'Authorization: Bearer adom_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

In Claude Code: claude mcp add --transport http agentdomains https://mcp.agentdomains.co --header "Authorization: Bearer adom_…"

Configuration

Variable	Purpose
`AGENTDOMAINS_API_KEY`	Your API key (`adom_…`). Falls back to `api_key` in `~/.agentdomains/config.json`.
`AGENTDOMAINS_API_URL`	Override the API base URL. Defaults to `https://api.agentdomains.co`.

If you already use the Go CLI, its ~/.agentdomains/config.json is picked up automatically and no env var is needed.

No key yet? Call the signup tool — it needs no credentials and returns one. The key is shown once and is never retrievable, so store it immediately. Accounts are provisional: attach an email with attach_email and confirm it within 30 days or the account and its domains are deleted.

The API key is never logged, printed, or included in any tool output.

Tools

Tool	Endpoint	Description
`check_availability`	`GET /v1/available`	Is a label free? No key required.
`signup`	`POST /v1/signup`	Create an account, get an API key (shown once). No key required.
`whoami`	`GET /v1/whoami`	Account state, email, quota, usage.
`attach_email`	`POST /v1/account/email`	Attach an email and send its verification link.
`claim_domain`	`POST /v1/subdomains`	Register `label.domain`, optionally with a first record.
`list_domains`	`GET /v1/subdomains`	List every name on the account.
`get_domain`	`GET /v1/subdomains/{label}`	One name, its records, forward/proxy state.
`delete_domain`	`DELETE /v1/subdomains/{label}`	Destructive — permanently delete a name and its records.
`add_dns_record`	`POST /v1/subdomains/{label}/records`	Add an A, AAAA, CNAME, or TXT record.
`delete_record`	`DELETE /v1/subdomains/{label}/records/{id}`	Destructive — remove one record, keeping the name. Ids come from `get_domain`.
`add_acme_challenge`	`POST /v1/subdomains/{label}/records`	TXT at `_acme-challenge` for Let's Encrypt DNS-01.
`set_forward`	`PUT /v1/subdomains/{label}/forward`	Redirect the name to a URL; replaces the address records on it.
`remove_forward`	`DELETE /v1/subdomains/{label}/forward`	Stop forwarding.
`set_proxy`	`PUT /v1/subdomains/{label}/proxy`	Serve a backend through the edge, with TLS terminated for you; replaces the address records on it.
`remove_proxy`	`DELETE /v1/subdomains/{label}/proxy`	Stop proxying.
`delegate_nameservers`	`PUT /v1/subdomains/{label}/ns`	Delegate the name to your own nameservers.
`delete_account`	`DELETE /v1/account[?force=true]`	Destructive — close the account and kill its key; refuses while names are held unless `force`.
`upgrade_to_pro`	`POST /v1/billing/checkout`	A Stripe checkout link for Pro (100 names, $5/month or $48/year). Charges nothing; a human opens the link and pays.
`manage_billing`	`POST /v1/billing/portal`	A Stripe billing-portal link for a Pro account (card, invoices, interval, cancel).

Every label-scoped tool takes an optional domain (makes.fyi, the default, or agentdomains.co).

Setting a forward or a proxy takes the hostname over. The A/AAAA/CNAME records on the label itself are deleted in the same call and handed back as replaced_records, so tell the user what moved. Sub-label records (www.myapp.makes.fyi) and TXT records are left alone, and if the forward fails to come up the replaced records are restored with new ids.

A claim and its first record stand or fall together. If claim_domain is given a record it cannot create, nothing is claimed — fix the record and call again. Re-claiming a name the account already holds answers 409 with owned:true, which means carry on.

On HTTPS

"Get me SSL" is not one operation here. Two honest paths:

set_proxy — the edge terminates TLS with its own certificate and proxies to your backend. Nothing to install on the origin.
add_acme_challenge — publishes the DNS-01 TXT record so your own ACME client can issue a Let's Encrypt certificate (needed for wildcards or hosts with no public port 80). A plain public web server can just use HTTP-01 and needs no DNS record at all.

Compatibility

Any MCP client works. Verified shapes for the common ones:

Claude Code — claude mcp add (stdio or --transport http), as above.
Claude Desktop — mcpServers block in claude_desktop_config.json.
OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "agentdomains-mcp"]}), or MCPServerStreamableHttp against the remote URL.
LangChain / LangGraph — langchain-mcp-adapters: MultiServerMCPClient({"agentdomains": {"command": "npx", "args": ["-y", "agentdomains-mcp"], "transport": "stdio"}}).
CrewAI — MCPServerAdapter with the same stdio parameters.
Anything else — point your client at npx -y agentdomains-mcp over stdio, or at https://mcp.agentdomains.co over Streamable HTTP.

Development

bash

npm install
npm run build     # tsc -> dist/
npm run smoke     # boots dist/index.js, runs initialize + tools/list over stdio

Requires Node 18+. The only runtime dependency is @modelcontextprotocol/sdk.

CLI (Go) — the agentdomains command
Agent skill — Claude Code plugin
Docs · HTTP API

License

FSL-1.1-Apache-2.0 — see LICENSE. Same terms as the CLI.

MCP Registry listing

This server is listed in the official MCP Registry as io.github.tashfeenahmed/agentdomains-mcp — the index PulseMCP, Glama and other agent-tool directories read from. The metadata is server.json in this repo.

Publishing is manual (GitHub Actions is not running on this account). On each npm release, bump version in server.json and its packages[0].version to match package.json, publish to npm first, then:

bash

# once: install the publisher (macOS/Linux)
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher

./mcp-publisher login github     # device-code flow as the tashfeenahmed GitHub account
./mcp-publisher publish          # uploads server.json
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.tashfeenahmed/agentdomains-mcp"

The registry checks that the npm package's mcpName matches name in server.json, so the npm version named in server.json must already be published.

docs/publish-mcp-registry.yml is an optional GitHub Actions workflow that does the same on a v* tag via GitHub OIDC. It only runs if moved to .github/workflows/ and Actions is available on the account.

Install

Tools (19)

check_availabilitysignupwhoamiattach_emailclaim_domainlist_domainsget_domaindelete_domain

Configuration

Environment variables

AGENTDOMAINS_API_KEYsecret

Your AgentDomains API key (adom_…). Only needed for calls that manage an account; check_availability works without one.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agentdomains-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "agentdomains-mcp@0.1.3"
      ],
      "env": {
        "AGENTDOMAINS_API_KEY": "<YOUR_AGENTDOMAINS_API_KEY>"
      }
    }
  }
}

Agent Domains MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

check_availability

signup

whoami

attach_email

claim_domain

list_domains

get_domain

delete_domain

add_dns_record

delete_record

add_acme_challenge

set_forward

remove_forward

set_proxy

remove_proxy

delegate_nameservers

delete_account

upgrade_to_pro

manage_billing

AgentDomains MCP server

Install (stdio)

Claude Code

Claude Desktop and other config-file clients

Remote endpoint

Configuration

Tools

On HTTPS

Compatibility

Development

Related

License

MCP Registry listing

Install

Configuration

Related servers