# Koru Shield

> Koru Shield is an open-source MCP server for security. Manage Koru Shield DNS filtering profiles, rules, schedules and logs by chat. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, CLI
- **Repository:** https://github.com/korushield/koru-shield-mcp
- **MCP Registry name:** com.korushield/koru-shield
- **Categories:** [security](https://ai-powered.com/categories/security), [home services](https://ai-powered.com/categories/home-services)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.korushield.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "koru-shield": {
      "url": "https://mcp.korushield.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Cisa Kev](https://ai-powered.com/mcp/cisa-kev): Cisa Kev is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/koru-shield
