Name: Podkop
Author: mikel38487

Podkop MCP

MCP server for managing Podkop and Forkop on OpenWrt over SSH

Grade A Local · stdio No auth needed 47 tools v0.2.2 MIT

No reviews yet by mikel38487PyPI 2,427 Runs on your machine, nothing hosted

94/100

trust score

downloads a day

local

runs on your machine

102

downloads in 30d

What it does

MCP server for managing Podkop and Forkop on OpenWrt over SSH

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --env 'PODKOP_MCP_SSH_HOST=${PODKOP_MCP_SSH_HOST}' --transport stdio podkop-mcp '--' uvx podkop-mcp

# 2 — ask your agent for something these tools do
#   podkop_connections_config, podkop_subscription_add, podkop_subscription_delete and 44 more

It needs PODKOP_MCP_SSH_HOST: this reads it from your environment, so export it first.

Podkop costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

mikel384871 server

1 category

All 1 server

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Installation

Where are you running it?

Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Podkop as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.

Claude Codedeclared by this listing

This is a public server: you run it yourself and this marketplace is not in the path. You need uv (docs.astral.sh/uv): uvx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. Claude Code reads PODKOP_MCP_SSH_HOST (Router address) from your environment each time it starts the server, so the value stays out of its config: export it in your shell profile (macOS, Linux), or run setx PODKOP_MCP_SSH_HOST … and open a new terminal (Windows). The '--' is in quotes so that PowerShell passes it on.

claude mcp add --scope user --env 'PODKOP_MCP_SSH_HOST=${PODKOP_MCP_SSH_HOST}' --transport stdio podkop-mcp '--' uvx podkop-mcp

Reconnect, or start a new session, and the tools appear in the model’s tool list.

Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.

What it asks of you

It reaches a system of yours, so it needs settings only you can give it: PODKOP_MCP_SSH_HOST — Router address. You set it in your own client’s config, on your machine — this marketplace never holds it.

What it writes

One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.

What you approve

47 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

Read from its source code. A server that builds its tool list when it starts can list more tools than this.

List routing sections with subscriptions, urltest groups, links and tunnels.

Parameter	Type	Required	Notes
target	string	no	—
section	string	no	—
reveal_secrets	boolean	no	—

Add a subscription to a section. Dry-run by default; apply=true writes.

Parameter	Type	Required	Notes
section	string	yes	—
url	string	yes	—
options	object	no	—
target	string	no	—
apply	boolean	no	—

Delete a subscription by name, 1-based index, tag or raw URL.

Parameter	Type	Required	Notes
identifier	string	yes	—
section	string	no	—
target	string	no	—
apply	boolean	no	—

Refresh subscription cache on the router (apply must be true).

Parameter	Type	Required	Notes
section	string	no	—
target	string	no	—
apply	boolean	no	—
wait	boolean	no	—
timeout	number	no	—

List Clash proxy groups and nodes with delays.

Parameter	Type	Required	Notes
target	string	no	—
group	string	no	—

Select a proxy inside a Clash group (runtime change, not config).

Parameter	Type	Required	Notes
group	string	yes	—
proxy	string	yes	—
target	string	no	—
apply	boolean	no	—

Run read-only proxy check and report selected-group delays.

Parameter	Type	Required	Notes
target	string	no	—

List domains of one section, normalized plus the raw stored value.

Parameter	Type	Required	Notes
section	string	no	—
target	string	no	—

Add domains to a section preserving the backend storage type.

Parameter	Type	Required	Notes
section	string	yes	—
domains	array	yes	—
target	string	no	—
apply	boolean	no	—
verify	boolean	no	—

Remove domains from a section, keeping the storage type intact.

Parameter	Type	Required	Notes
section	string	yes	—
domains	array	yes	—
target	string	no	—
apply	boolean	no	—

Replace the whole domain set of a section.

Parameter	Type	Required	Notes
section	string	yes	—
domains	array	yes	—
target	string	no	—
apply	boolean	no	—

Find where a domain is covered by section entries.

Parameter	Type	Required	Notes
domain	string	yes	—
target	string	no	—

Suggest hosts seen in live connections but not covered by any section.

Parameter	Type	Required	Notes
target	string	no	—
limit	integer	no	—
only_direct	boolean	no	—

Check one domain: DNS resolution, FakeIP, section coverage, HTTPS probe.

Parameter	Type	Required	Notes
domain	string	yes	—
target	string	no	—
probe_http	boolean	no	—

Return the full UCI configuration as structured JSON.

Parameter	Type	Required	Notes
target	string	no	—
package	string	no	—
reveal_secrets	boolean	no	—
include_raw	boolean	no	—

Export the UCI config as text (backup-style).

Parameter	Type	Required	Notes
target	string	no	—
mode	string	no	—
reveal_secrets	boolean	no	—

Read a single UCI option or section by path, e.g. forkop.main.domain.

Parameter	Type	Required	Notes
path	string	yes	—
target	string	no	—
reveal_secrets	boolean	no	—

Set a UCI option or list. Dry-run by default; apply=true writes, backs up and reloads.

Parameter	Type	Required	Notes
path	string	yes	—
value	string/array	no	—
target	string	no	—
value_type	string	no	—
apply	boolean	no	—
reason	string	no	—

Delete a UCI option. Dry-run by default; apply=true writes with backup.

Parameter	Type	Required	Notes
path	string	yes	—
target	string	no	—
apply	boolean	no	—
reason	string	no	—

Create a config backup on the router (dry-run by default).

Parameter	Type	Required	Notes
target	string	no	—
reason	string	no	—
apply	boolean	no	—

List config backups stored on the router.

Parameter	Type	Required	Notes
target	string	no	—
limit	integer	no	—

Restore a config backup by id. Dry-run shows the action; apply=true restores and reloads.

Parameter	Type	Required	Notes
backup_id	string	yes	—
target	string	no	—
apply	boolean	no	—

Return selected and available community lists of sections.

Parameter	Type	Required	Notes
section	string	no	—
target	string	no	—

Add or remove community lists of one section as a UCI list.

Parameter	Type	Required	Notes
section	string	yes	—
add	array	no	—
remove	array	no	—
target	string	no	—
apply	boolean	no	—

Return a monitoring snapshot: service, system, proxies, connections, traffic.

Parameter	Type	Required	Notes
target	string	no	—
include_connections	boolean	no	—
top	integer	no	—

List live connections with optional filters (host, source_ip, chain).

Parameter	Type	Required	Notes
target	string	no	—
host	string	no	—
source_ip	string	no	—
chain	string	no	—
limit	integer	no	—

Measure traffic rate by sampling Clash connections twice.

Parameter	Type	Required	Notes
target	string	no	—
sample_seconds	number	no	—
top	integer	no	—

List routing sections with action, enabled flag, domain counts and lists.

Parameter	Type	Required	Notes
target	string	no	—
include_children	boolean	no	—
reveal_secrets	boolean	no	—

Return all options of one section plus its child items.

Parameter	Type	Required	Notes
section	string	yes	—
target	string	no	—
reveal_secrets	boolean	no	—
include_children	boolean	no	—

Create a new routing section. Dry-run by default.

Parameter	Type	Required	Notes
name	string	yes	—
action	string	no	—
options	object	no	—
target	string	no	—
apply	boolean	no	—

Create a Forkop 2.x tunnel child (WARP/WireGuard/OpenVPN/...). Dry-run by default.

Parameter	Type	Required	Notes
section	string	yes	—
name	string	yes	—
kind	string	yes	—
label	string	no	—
options	object	no	—
target	string	no	—
apply	boolean	no	—

Create a generic Forkop 2.x child (urltest/fallback_group/link/interface/json/tunnel_peer).

Parameter	Type	Required	Notes
section	string	yes	—
child_type	string	yes	—
name	string	yes	—
label	string	no	—
options	object	no	—
target	string	no	—
apply	boolean	no	—

Update selected options of a section (partial update). Dry-run by default.

Parameter	Type	Required	Notes
section	string	yes	—
options	object	yes	—
target	string	no	—
apply	boolean	no	—

Delete a section. Child items are deleted when cascade=true.

Parameter	Type	Required	Notes
section	string	yes	—
target	string	no	—
cascade	boolean	no	—
allow_main	boolean	no	—
apply	boolean	no	—

Enable or disable a section without deleting it.

Parameter	Type	Required	Notes
section	string	yes	—
enabled	boolean	yes	—
target	string	no	—
apply	boolean	no	—

Start, stop, restart, reload or toggle autostart of Podkop/Forkop.

Parameter	Type	Required	Notes
action	string	yes	—
target	string	no	—
apply	boolean	no	—
wait	boolean	no	—
timeout	number	no	—

Update built-in lists and/or subscriptions.

Parameter	Type	Required	Notes
kind	string	no	—
target	string	no	—
apply	boolean	no	—
wait	boolean	no	—
timeout	number	no	—

Check MCP configuration, SSH connectivity, backend and capabilities.

Parameter	Type	Required	Notes
target	string	no	—

Return service, sing-box, DNS and version status of the router.

Parameter	Type	Required	Notes
target	string	no	—

Return sing-box features compiled into the installed Forkop core (read-only).

Parameter	Type	Required	Notes
target	string	no	—

Validate a Forkop config file on the router without applying it (read-only).

Parameter	Type	Required	Notes
path	string	yes	—
target	string	no	—

Return the status of the last Forkop installer run (read-only).

Parameter	Type	Required	Notes
target	string	no	—
offset	integer	no	—

Return the last Forkop installer log, redacted (read-only).

Parameter	Type	Required	Notes
target	string	no	—

Return model, OpenWrt version, kernel, load, memory, disk and WAN info.

Parameter	Type	Required	Notes
target	string	no	—

Run read-only health checks: sing-box, nftables, FakeIP and DNS.

Parameter	Type	Required	Notes
target	string	no	—
full	boolean	no	—
timeout	number	no	—

Return recent router logs, filtered and redacted.

Parameter	Type	Required	Notes
target	string	no	—
source	string	no	—
lines	integer	no	—
filter	string	no	—

Run a read-only Forkop/Podkop CLI command from the allowlist.

Parameter	Type	Required	Notes
command	string	yes	—
args	array	no	—
target	string	no	—
parse_json	boolean	no	—
reveal_secrets	boolean	no	—
timeout	number	no	—

Free

$0 forever

Every tool, no call limit
No card, and mcprush charges nothing for it
Source published under MIT
Runs on your machine — nothing of it reaches our gateway
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install Podkop or to call it, at any volume.

ATrust score 94 / 100

Release 0.2.2 · scanned 2 Nov 2026

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score94

Findings3 threat · 4 capability

Capabilityhigh

Coveragesource

Verificationsource

Surface digest7aaba20ae51a211d92e5ca89919face327c835772de3e32812d6cfb37623eceb

Score vectorthreat 100 → client 94

Term	Level	What it prices	Points
capability-exposure	high	capability blast radius (high) — client exposure if the model is manipulated	−6
verification-discount	source	publisher verification (provenance) — cryptographic build provenance ties the artifact to its source	−0
coverage-honesty	source	inspection depth (source) — how much of the target the scan could see	−0

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

Tool surfaceread

Implementation sourceread

Package metadataread

Live transportnot available

Tools were statically extracted from the published source (47 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. high is the level these add up to.

Tool	Capability tags	Why the tag was assigned
podkop_config_get	no tags
podkop_config_export	no tags
podkop_option_get	no tags
podkop_option_set	no tags
podkop_option_delete	no tags
podkop_backup_create	no tags
podkop_backup_list	no tags
podkop_backup_restore	no tags
podkop_connections_config	no tags
podkop_subscription_add	no tags
podkop_subscription_delete	no tags
podkop_subscription_update	no tags
podkop_proxies_list	no tags
podkop_proxy_select	no tags
podkop_proxy_test	no tags
podkop_domains_list	no tags
podkop_domains_add	no tags
podkop_domains_remove	no tags
podkop_domains_replace	no tags
podkop_domains_find	no tags
podkop_domains_suggest	no tags
podkop_domain_check	no tags
podkop_community_lists_get	no tags
podkop_community_lists_update	no tags
podkop_monitor_snapshot	no tags
podkop_connections_live	no tags
podkop_traffic	untrusted-input	untrusted-input: keyword "download"
podkop_sections_list	no tags
podkop_section_get	no tags
podkop_section_create	no tags
podkop_tunnel_create	no tags
podkop_child_create	no tags
podkop_section_update	no tags
podkop_section_delete	no tags
podkop_section_enable	no tags
podkop_service_action	no tags
podkop_lists_update	no tags
podkop_doctor	no tags
podkop_status	no tags
podkop_core_features	no tags
podkop_import_check	no tags
podkop_installer_status	no tags
podkop_installer_log	no tags
podkop_system_info	no tags
podkop_health	no tags
podkop_logs	no tags
podkop_cli	code-exec	code-exec: parameter "command"

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

flow-1

Untrusted input can drive an external action even though no sensitive source is exposed.

Supply chain and provenance

Integrityfirst-seen

Surface digest7aaba20ae51a211d

Scanned2026-11-02

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.