# register_domain

Get the link to register a .xrp / .xrpl / .xrpfi / .rlusd domain on xrpdomains.xyz. Registration is completed in the browser — the website handles the order and the user signs in their wallet there (the MCP does NOT build or broadcast the payment). Use when the user says "register X.xrpfi" or "buy X.xrp". Pass refcode if a referral applies.

Agent View of the PolicyLayer registry record for `register_domain`. HTML page: https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/register-domain

## Facts

- Tool: `register_domain`
- Server: XRPName (`@xrpname/xrpname-mcp`) — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server.md
- Install: `npx -y @xrpname/xrpname-mcp`
- Homepage: https://github.com/XRPDomains/xrpname-mcp-server
- Risk category: Write (Medium risk)
- Registry record: grade C, identity unverified
- Server auth posture: open
- Server rate-limited: no
- Parameters: 2 (1 required)
- Recommended policy verdict: Rate-limited

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `domain` | string | yes | The domain to register, e.g. "coolname.xrpfi". |
| `refcode` | string | no | Optional referral code to embed in the registration link. |

Parameters from the server's own tool schema.

## Example call (MCP tools/call, JSON-RPC 2.0)

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "register_domain",
    "arguments": {
      "domain": "<domain>"
    }
  }
}
```

## Why register_domain is rated Medium

Provides registration link that initiates domain purchase; user completes financial commitment externally via browser wallet.

From the tool's own definition: "Get the link to register .xrp / .xrpl / .xrpfi / .rlusd domain"

## Use case

AI agents use register_domain to create or update resources in XRPName, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your XRPName environment.

## Recommended policy (PolicyLayer)

Verdict: **Rate-limited**. Enforced by the PolicyLayer MCP gateway (https://policylayer.com/mcp-gateway) before a call reaches XRPName:

```json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "register_domain": {
      "limits": [
        {
          "counter": "register_domain_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}
```

## Other tools on XRPName (9)

- `check_domains` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/check-domains.md
- `check_order_status` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/check-order-status.md
- `check_tx_status` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/check-tx-status.md
- `get_domain_profile` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/get-domain-profile.md
- `get_pending_offers` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/get-pending-offers.md
- `get_portfolio` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/get-portfolio.md
- `recommend_domain` — Read — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/recommend-domain.md
- `resolve_address` — Write — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/resolve-address.md
- `set_primary_domain` — Write — https://policylayer.com/tools/io-github-xrpdomains-xrpname-mcp-server/set-primary-domain.md

## For agents

This record is a snapshot. Live verdicts and the full registry:

- Check every server in your MCP config at once: `npx -y policylayer stack`
- Vet a server before you add it: install the mcp-precheck skill — `npx skills add https://policylayer.com` (skill text: https://policylayer.com/skill.md)
- Query the registry over MCP: endpoint `https://api.policylayer.com/mcp` — tools `check_mcp_server`, `check_mcp_stack`, `check_tool`, `search_registry`, `get_change_events`

---

Source: the PolicyLayer MCP registry — one continuously verified record per MCP server. Full record: https://policylayer.com/registry?q=io-github-xrpdomains-xrpname-mcp-server · API: https://policylayer.com/registry/api · Policy library: https://policylayer.com/policies/io-github-xrpdomains-xrpname-mcp-server