Grades are a hygiene check, not a security guarantee.

MCP, MCP server

com.thingctx/thingctx

thingctx turns a description of any API, device, or local process into tools an AI agent can call: authorized per operation, over the system's own transport, and the agent never holds your keys. The description is a W3C Web of Things Thing Descripti

Compatibility: Not stated.

Grade D

Two or more Medium findings, or a High finding. Only try it in a sandbox.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

Rescanned at commit 102f85800916, unchanged since the check below.

NETWORK_HOST_FROM_INPUT PERMISSION_SHELL_UNDECLARED SECRETS_PATH_CREDENTIAL

Why this grade

  • NETWORK_HOST_FROM_INPUT High

    A file takes a URL or endpoint as input and has no fixed host list.

    examples/11_media_video.py, line 80 with urllib.request.urlopen(url, timeout=30) as resp:

  • PERMISSION_SHELL_UNDECLARED Medium

    Runs shell commands that the manifest or description does not mention.

    examples/09_rtsp_local.py, line 86 def _publish_test_pattern() -> subprocess.Popen:

  • SECRETS_PATH_CREDENTIAL Medium

    Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).

    .gitignore, line 28 id_rsa

Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.

If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.

Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.

What was checked

Plain notes from the hygiene checks.

  • Permissions

    Concern

    requests shell access. No manifest field names shell or command execution. can delete files.

    PERMISSION_SHELL_UNDECLARED PERMISSION_DELETE_FILES

    examples/09_rtsp_local.py, line 86

    def _publish_test_pattern() -> subprocess.Popen:

    examples/09_rtsp_local.py, line 112

    return subprocess.Popen(cmd, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)

    examples/09_rtsp_local.py, line 140

    server = subprocess.Popen(

    Show more

    examples/09_rtsp_local.py, line 143

    publisher: subprocess.Popen | None = None

    examples/12_media_publish.py, line 128

    server = subprocess.Popen(

    examples/_measure.py, line 167

    def start_http_mcp(td) -> tuple[subprocess.Popen, str]:

    examples/_measure.py, line 172

    proc = subprocess.Popen([sys.executable, str(HERE / "_mcp_http_server.py")], env=env)

    examples/_pump.py, line 346

    proc = subprocess.Popen(

  • Install and update

    Pass

    No install-time script found, and dependencies are pinned or absent.

  • Network

    Serious

    accepts a host from input, with no fixed list in this file.

    NETWORK_HOST_FROM_INPUT

    examples/11_media_video.py, line 80

    with urllib.request.urlopen(url, timeout=30) as resp:

    examples/13_custom_stack.py, line 75

    def fetch(self) -> list[dict]:

    examples/_measure.py, line 175

    with socket.create_connection(("127.0.0.1", port), timeout=0.2):

    Show more

    examples/_pump.py, line 399

    with urllib.request.urlopen("http://localhost:11434/api/tags", timeout=1) as r:

    examples/interop/ditto/capture_td.sh, line 25

    [ "$(curl -s -o /dev/null -w '%{http_code}' -u ditto:ditto "$BASE/things")" = "200" ] && break

    examples/interop/ditto/capture_td.sh, line 28

    if [ "$(curl -s -o /dev/null -w '%{http_code}' -u ditto:ditto "$BASE/things")" != "200" ]; then

    examples/interop/ditto/capture_td.sh, line 36

    curl -fsS -u ditto:ditto -X PUT "$BASE/things/$THING_ID" \

    examples/interop/ditto/capture_td.sh, line 41

    curl -fsS -u ditto:ditto -H 'Accept: application/td+json' \

    examples/interop/nodewot/drive_nodewot_td.py, line 30

    td = (await http.get(TD_URL)).json()

    src/thingctx/registry.py, line 15

    a fetch().

    src/thingctx/registry.py, line 188

    with urllib.request.urlopen(req, timeout=timeout) as r: # noqa: S310 (scheme checked above)

    src/thingctx/bindings/builtin/media/backends.py, line 499

    urllib.request.urlopen( # noqa: S310 (scheme checked above)

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_CREDENTIAL SECRETS_PATH_DOTENV

    examples/05_oauth2.py, line 35

    CLIENT_SECRET = os.environ.get("THINGCTX_DEMO_CLIENT_SECRET", "s3cret")

    examples/05_oauth2.py, line 36

    VALID_TOKEN = os.environ.get("THINGCTX_DEMO_TOKEN", "demo-access-token-123")

    .gitignore, line 28

    id_rsa

    Show more

    examples/09_rtsp_local.py, line 40

    PASSWORD = os.environ.get("THINGCTX_DEMO_RTSP_PASSWORD", "p@ssw0rd!")

    examples/11_media_video.py, line 55

    if os.environ.get("OPENROUTER_API_KEY"):

    examples/_pump.py, line 151

    DEVICE_TOKEN = os.environ.get("THINGCTX_DEMO_DEVICE_TOKEN", "demo-bearer-token")

    examples/_pump.py, line 416

    if os.environ.get("OPENROUTER_API_KEY"):

    examples/_pump.py, line 443

    if os.environ.get("OPENROUTER_API_KEY"):

    src/thingctx/auth/secret.py, line 84

    lock = os.environ.get("THINGCTX_MLOCK_SECRETS", "") not in ("", "0", "false")

    .gitignore, line 19

    # Secrets and credentials, never commit (a *.example template is fine)

    .gitignore, line 20

    .env

    .gitignore, line 22

    !.env.example

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit 102f85800916. requests shell access. No manifest field names shell or command execution. can delete files. accepts a host from input, with no fixed list in this file. reads a credential or environment file.

Date and source

Date checked:

View source

github.com

Commit graded: 102f858009160c6e3d5c48045caa644f3068ad78

This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.

Read how this letter is chosen