Skip to content
MCP server

Koru Shield

Manage Koru Shield DNS filtering profiles, rules, schedules and logs by chat

Install
Pricing
Open source
Platforms
macOS, Windows, Linux
Runs
Locally or Remotely
Version
1.0.1
Listing updated
today

Similar MCP servers

About Koru Shield

Koru Shield is an open-source MCP server for security. It can run locally on your machine or as a hosted remote server.

The server turns a Koru Shield account into tools an assistant can use, aimed at home or family DNS protection. You can ask it to block a domain on a named profile such as Kids, check whether a site would be blocked right now with simulate_policy, toggle filter categories, add bedtime or homework schedules, and review what was blocked today.

It authenticates with an API key created in the Koru Shield dashboard. The README warns that this key has full control of the account, including deleting rules and schedules, so it suggests a dedicated key for assistants that can be revoked on its own. The key is sent only to the Koru Shield API.

It runs locally through npx over stdio, or in HTTP mode where the key is passed as a bearer token, and there is also a hosted endpoint at mcp.korushield.com. Analytics tools report totals, blocked percentage and encrypted query counts, and entitlement and referral tools show plan limits and a referral link.

Install

Run in a terminal

claude mcp add --transport http koru-shield https://mcp.korushield.com/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.korushield.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "koru-shield": {
      "url": "https://mcp.korushield.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "koru-shield": {
      "type": "http",
      "url": "https://mcp.korushield.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "koru-shield": {
      "serverUrl": "https://mcp.korushield.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "koru-shield": {
      "type": "http",
      "url": "https://mcp.korushield.com/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • KORU_SHIELD_API_KEYYour Koru Shield API key (create one in the dashboard at https://my.korushield.com under Settings > API Keys)Required

Tools this server provides (16)

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

list_profiles
Lists DNS protection profiles
get_profile
Inspects a profile
create_rule
Blocks or allows a domain on a profile
list_rules
Lists rules
delete_rule
Deletes a rule
list_filter_categories
Lists filter categories
set_filter_category
Toggles a filter category
simulate_policy
Checks whether a domain would be blocked now
get_logs
Shows recent DNS queries
analytics_summary
Gives totals, blocked percentage and encrypted queries
list_schedules
Lists schedules
create_schedule
Creates a time window schedule
delete_schedule
Deletes a schedule
list_devices
Lists devices enrolled per profile
get_entitlements
Shows plan, limits and usage
get_referral_code
Returns a referral link

What it does

Profile and rule control
Lists profiles and creates or deletes block and allow rules per profile.
Policy simulation
Checks whether a domain would be blocked at this moment.
Category toggles
Turns filter categories such as adult, gambling or social media on and off.
Schedules
Creates time windows like bedtime or homework hours.
Query logs and analytics
Shows recent DNS queries and blocked-percentage summaries.
Dual transport
Runs over stdio via npx or HTTP with a bearer key.

Good for

  • Block a distracting site on a child's profile
  • Ask whether a site is blocked right now
  • Set a weekday bedtime schedule
  • Review what DNS queries were blocked today

Pricing

Open source

Server is MIT licensed; requires a Koru Shield account

Koru Shield FAQ

How does it authenticate?

With a Koru Shield API key created under Settings, then API Keys, in the dashboard.

Is the API key risky?

It grants full control of the account, so the README advises a dedicated, revocable key.

How do I run it?

Use npx -y korushield-mcp-server, or run it in HTTP mode, or use the hosted endpoint.

What licence is it under?

MIT.

Is Koru Shield free?

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

How do I add Koru Shield to Claude Code?

Run this command in your terminal: claude mcp add --transport http koru-shield https://mcp.korushield.com/mcp

What are the best alternatives to Koru Shield?

The closest alternatives to Koru Shield are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers