dnsimple-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
dnsimple-mcp
An MCP server for DNSimple that wraps the official dnsimple CLI and signs in with OAuth in your browser. There is no API token to create, paste into a config file, or hand to a model.
OAuth, not tokens.
dnsimple_auth_loginruns the CLI's own authorization-code + PKCE flow: your browser opens, you approve, done. The credential goes straight into the CLI's store; the server never reads it,--tokenis refused, andDNSIMPLE_TOKENis stripped from the CLI's environment.Tracks your CLI. The command catalog is read from the installed CLI at startup (
dnsimple ai --full), so new CLI commands show up without a new release of this server.Reads and writes are separate tools, so a client can auto-approve reads and still ask before anything changes.
Requirements
Node.js 20+
The
dnsimpleCLI on yourPATH(brew install dnsimple/tap/dnsimple, or see the CLI repo)macOS or Linux for the browser login (it needs the
scriptutility for a pseudo-terminal). Elsewhere, rundnsimple auth loginonce in a terminal; everything else works.
Related MCP server: cloudflare-mcp
Install
Claude Code:
claude mcp add dnsimple -- npx -y --allow-git=all github:Kinark/dnsimple-mcpAny other MCP client (stdio):
{
"mcpServers": {
"dnsimple": {
"command": "npx",
"args": ["-y", "--allow-git=all", "github:Kinark/dnsimple-mcp"]
}
}
}--allow-git=all is needed on npm 12+, which refuses packages from git by default. Or run it from a clone:
git clone https://github.com/Kinark/dnsimple-mcp && cd dnsimple-mcp && npm install
claude mcp add dnsimple -- node "$PWD/bin/dnsimple-mcp.js"If you are already signed in with the CLI, it works immediately. Otherwise ask the assistant to sign in to DNSimple and approve the request in the browser.
Tools
Tool | What it does |
| Runs a read-only command ( |
| Runs a command that creates, changes or deletes something. Marked destructive. |
| The CLI reference, or the full help of one command. |
| Who is signed in, which environment, stored contexts, login in progress. |
| OAuth sign-in in the browser ( |
| Makes another stored context active. |
| Removes a stored context. |
dnsimple_query and dnsimple_mutate take the same input:
{
"command": "zones records create",
"args": ["example.com"],
"flags": { "type": "A", "name": "www", "content": "1.2.3.4", "ttl": 3600 },
"account": 1234
}The request is checked against the catalog before the CLI runs: unknown commands, wrong argument counts, unknown flags and missing required flags come back as errors that say what is valid. --json is always applied, and --yes is added to commands that would otherwise prompt.
Things to know
dnsimple_mutatedoes not prompt. Your MCP client's approval of the tool call is the confirmation. Registrar and certificate commands (registrar register,registrar renew,certificates letsencrypt purchase, …) can charge your account. Keep that tool on "ask every time".Signing in changes the active CLI context for every
dnsimpleuser on the machine, asdnsimple auth logindoes. To keep the server on one context regardless, pin it.The browser must open on the machine running the server: the OAuth callback goes to
127.0.0.1.
Configuration
Option | Effect |
| Pin every call to one stored CLI context (safe alongside other agents; disables switching). |
| Path to the |
| Don't launch a browser on login; only return the authorize URL. |
To play safely, use the sandbox: ask for a sandbox login (creates a sandbox context), then run the server with --context sandbox.
Development
npm install
npm testThe suite has three layers: catalog parsing against a recorded CLI reference, end-to-end MCP calls over stdio against a fake CLI (asserting the exact argv), and live tests against the installed CLI. The live tests are read-only, skip themselves when the CLI is missing or signed out, and exercise the OAuth login in a throwaway HOME without opening a browser.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage Fly.io apps, Machines, volumes, secrets, Managed Postgres, and Sprites with OAuth.
MCP server for DNSimple — domains, DNS zone records, availability, pricing and contacts.
Manage Kubana Cloud DNS zones and A, AAAA, CNAME, MX, TXT and NS records; check delegation.
Read-only DNS-01 setup guides and templates for Traefik, win-acme, Certbot and custom hooks.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables to manage 1Password resources including vaults, items, documents, users, groups, and more through the 1Password CLI, exposing 65 tools for comprehensive password management via natural language.-
- AlicenseNot gradedqualityCmaintenanceManages DNS records and Cloudflare Tunnels for a Cloudflare zone via the Cloudflare API. Supports listing, creating, updating, and deleting DNS records, as well as tunnel lifecycle operations.MIT
- AlicenseAqualityBmaintenanceEnables safe, authenticated access to GitHub via local GitHub CLI, providing read-only operations such as listing repositories, issues, and pull requests.641MIT
- AlicenseBqualityCmaintenanceProvides typed tools for DNS, zone, and cache management plus a universal passthrough to any Cloudflare API v4 endpoint, with confirmation required for destructive operations.8MIT