Skip to content
MCP server

AdminKit

Open-source MCP server for IP, DNS, mail-auth and MCP endpoint checks

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
3 days ago

About AdminKit

AdminKit is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

AdminKit's connector replaces guessing about a user's IP, DNS or MCP exposure with real lookups. Thirteen tools call AdminKit's live Check API or run pure local computation, and when a check cannot be reached the tool says so rather than inventing a result. It runs over stdio with uvx adminkit-mcp or pip install adminkit-mcp on Python 3.12+, or over streamable HTTP with adminkit-mcp --http.

The network-facing tools cover the caller's own IP and ASN with a CGNAT hint, DNS record lookups, SPF and DMARC posture, domain health covering whois, TLS and HTTP security headers, port checks for targets you have verified you own, and an exposure probe for an MCP server that sends only initialize and tools/list. Offline utilities handle subnet math, IP and IPv6 inspection, MAC vendor lookup and User-Agent parsing.

The repository also ships a read-only GitHub Action that scans your own MCP endpoint and returns a 0-100 exposure score. explain_report and higher limits need an optional ADMINKIT_API_KEY. The code is MIT licensed, version 0.1.0.

Install

Run in a terminal

claude mcp add adminkit-mcp --env ADMINKIT_API_KEY='<ADMINKIT_API_KEY>' -- uvx adminkit-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "adminkit-mcp": {
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "adminkit-mcp": {
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "adminkit-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "adminkit-mcp": {
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "adminkit-mcp": {
      "command": "uvx",
      "args": [
        "adminkit-mcp"
      ],
      "env": {
        "ADMINKIT_API_KEY": "<ADMINKIT_API_KEY>"
      }
    }
  }
}

Configuration

  • ADMINKIT_API_KEYOptional AdminKit API key (explain_report, read-only list_assets and get_asset, higher limits)

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

check_ip
Returns the caller's own public IP, ASN and a CGNAT hint.
dns_lookup
Looks up A, AAAA, MX, TXT, NS, CAA, PTR, SOA or CNAME records.
check_mail_auth
Validates SPF and DMARC posture for a domain.
check_domain
Aggregate domain health from whois, TLS certificate and HTTP security headers.
check_owned_ports
Port exposure check for targets you have verified you own.
check_mcp_endpoint
Probes an MCP server using initialize and tools/list only.
explain_report
Plain-language AI explanation of a shared AdminKit report; needs an API key.
get_radar
Aggregated honeypot and telemetry trends.
subnet_calc
Subnet details for a CIDR.
ip_info
Inspects an IP address.
ipv6_info
Inspects an IPv6 address.
mac_vendor
Looks up the vendor for a MAC address or OUI prefix.
user_agent
Parses a User-Agent string into browser, OS and device family.

What it does

Network and DNS checks
Look up your own IP, DNS records and mail authentication for a domain.
Domain health overview
Combines whois, TLS certificate and HTTP security header checks.
MCP endpoint probe
Checks an MCP server for anonymous access and auth or TLS posture without calling tools.
Owned-port check
Port exposure checks limited to targets you have verified you own.
Offline utilities
Subnet math, IP and IPv6 inspection, MAC vendor lookup and User-Agent parsing.
GitHub Action scan
Scores your own MCP endpoint's exposure in CI on every push or schedule.

Good for

  • Have an agent verify SPF and DMARC for a domain
  • Diagnose DNS records without leaving the chat
  • Scan your own MCP server for anonymous tool access before release
  • Calculate subnet ranges for a CIDR block
  • Identify a device vendor from a MAC address

Pricing

Open source

MIT licensed connector; hosted plans are custom quotes

Prices change. Check adminkit.net before you buy.

AdminKit FAQ

How do I install it?

Run `uvx adminkit-mcp` or `pip install adminkit-mcp`; Python 3.12 or newer is required.

Is an API key required?

No. The key is optional and only enables explain_report and higher limits.

Can it scan any server's ports?

No. Port checks are limited to targets you have verified you own.

Does the MCP scan call the server's tools?

No. It sends only initialize and tools/list, never tools/call.

Is AdminKit free?

Yes. AdminKit is open source, so you can use and self-host it for free.

How do I add AdminKit to Claude Code?

Run this command in your terminal: claude mcp add adminkit-mcp --env ADMINKIT_API_KEY='<ADMINKIT_API_KEY>' -- uvx adminkit-mcp

What are the best alternatives to AdminKit?

The closest alternatives to AdminKit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to AdminKit

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools