Koru Shield
Manage Koru Shield DNS filtering profiles, rules, schedules and logs by chat
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.korushield.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"koru-shield": {
"url": "https://mcp.korushield.com/mcp"
}
}
}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.



