Odel
MCP server: One MCP server.

Koru Shield

@korushieldRun by its publisher: served from their own domain, namespace checked by the registry.MCP server · External

Manage Koru Shield DNS filtering: profiles, rules, categories, schedules, and logs.

Networkingv1.0.1MITTypeScript
Freeno charge per call
Sign in to install

One address for any MCP client. Your key stays in your Odel vault.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: creates or changes data: records, files, settings.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Tools

None listed · checked 5 Oct 2026

Odel could not list its tools without signing in.

Try it in the Inspector
README2 min read

Koru Shield MCP Server

Manage your Koru Shield DNS protection through AI assistants. Block domains, check policies, review blocked queries, manage schedules, and more, all through natural language.

What it does

Exposes your Koru Shield account as Model Context Protocol tools:

ToolWhat it does
list_profiles / get_profileList and inspect DNS protection profiles
create_rule / list_rules / delete_ruleBlock or allow domains per profile
list_filter_categories / set_filter_categoryToggle categories (adult, gambling, social media...)
simulate_policyCheck if a domain would be blocked right now
get_logsRecent DNS queries: allowed, blocked, when
analytics_summaryTotals, blocked percentage, encrypted queries
list_schedules / create_schedule / delete_scheduleTime windows (bedtime, homework hours)
list_devicesDevices enrolled per profile
get_entitlementsPlan, limits, current usage
get_referral_codeYour referral link

Example prompts once connected:

  • "Block tiktok.com on the Kids profile"
  • "Would youtube.com be blocked on Kids right now?"
  • "Show me what got blocked today"
  • "Turn on adult content filtering for the whole house"
  • "Add a bedtime schedule 9pm to 7am on weekdays for the Kids profile"

Setup

1. Get a Koru Shield API key

Sign in at https://my.korushield.com, go to API keys, and create one. Copy the key.

2. Install

No install needed. Run directly with npx:

bash
npx -y korushield-mcp-server

Set your key as an environment variable:

bash
export KORU_SHIELD_API_KEY="your-key-here"

Optional: KORU_SHIELD_API_URL overrides the API base URL (default https://my.korushield.com/api).

3. Connect your AI client

Claude Code

bash
claude mcp add koru-shield -- npx -y korushield-mcp-server

(Claude Code passes environment through, so export KORU_SHIELD_API_KEY first. Or use the HTTP transport below with a header.)

Cursor / VS Code

Add to your MCP config (~/.cursor/mcp.json or VS Code mcp.json):

json
{
  "mcpServers": {
    "koru-shield": {
      "command": "npx",
      "args": ["-y", "korushield-mcp-server"],
      "env": {
        "KORU_SHIELD_API_KEY": "your-key-here"
      }
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

json
{
  "mcpServers": {
    "koru-shield": {
      "command": "npx",
      "args": ["-y", "korushield-mcp-server"],
      "env": {
        "KORU_SHIELD_API_KEY": "your-key-here"
      }
    }
  }
}

HTTP transport (remote)

For clients that connect over HTTP (agents, hosted setups):

bash
MCP_TRANSPORT=http PORT=3000 KORU_SHIELD_API_KEY="your-key-here" npx -y korushield-mcp-server

Or pass the key per-request instead of the env var:

POST https://your-host/mcp
Authorization: Bearer <koru-shield-api-key>

Health check: GET /healthz.

Security notes

  • Your API key grants full control of your Koru Shield account, including deleting rules and schedules. Treat it like a password.
  • Prefer a dedicated API key for AI assistants so you can revoke it independently.
  • The server never logs or transmits your key anywhere except to the Koru Shield API.

Development

bash
npm install
npm run build
npm start

Test with the MCP Inspector:

bash
KORU_SHIELD_API_KEY="your-key-here" npm run inspector

License

MIT

Similar modules

Browse Networking