Skills/npm/foundryvtt-mcp

foundryvtt-mcp@1.5.5

VERIFIED· startup only

Publisher claims: "Model Context Protocol server for FoundryVTT integration" Observed in sandbox: no network, touches nothing outside the project, writes no memory.

Registry npm (MCP server)Publisher laurigates · publishing for 259 daysInstalls 392Last detonated 1 h ago
$claude mcp add foundryvtt-mcp -- npx -y foundryvtt-mcp
WatchReport an issue

Coverage

Startup only; authenticated tool behavior not tested.
Tested
server startup over stdio (initialize sent) · every file read, file written and host contacted by what ran
Not tested
the tool list (the server exited before answering) · what the tools do when called with real credentials

What this means for the label: Verified here covers what ran. The server's tools were not exercised with a real credential, so nothing about their behavior is asserted; the credential summary below says what to do with that.

Before you give it your token

It will ask for
FOUNDRY_API_KEYFOUNDRY_PASSWORDConfiguration, not credentials: CACHE_ENABLED, CACHE_MAX_SIZE, CACHE_TTL_SECONDS, FOUNDRY_RETRY_ATTEMPTS, FOUNDRY_RETRY_DELAY, FOUNDRY_SOCKET_PATH, FOUNDRY_TIMEOUT, FOUNDRY_URL, FOUNDRY_USER_ID, FOUNDRY_USERNAME, FOUNDRY_WRITE_ENABLED, MCP_SERVER_NAME, MCP_SERVER_VERSION
Where it talks to
foundryvtt.com (its own)
What we saw when it ran
no credential files read · no network
What we could not test
the tool list (the server exited before answering) · what the tools do when called with real credentials

Connect it with a scoped credential, under the guard. It asks for FOUNDRY_API_KEY, FOUNDRY_PASSWORD and talks to foundryvtt.com. Give the credential to the guard, not the server: the value never enters the server's environment and only travels to the host you bind. What the tools do with a real credential was not observed.

$vet-skills run --secrets FOUNDRY_API_KEY=foundryvtt.com,FOUNDRY_PASSWORD=foundryvtt.com -- npx -y foundryvtt-mcp

Never paste a credential into a chat, a ticket or a report, including ours. How the guard holds it.

What changed since 1.5.3

vet-skills diff foundryvtt-mcp 1.5.3 1.5.5

In the sandbox, this version reached for nothing 1.5.3 did not. Compared from the two recorded runs, not from source.

The guard can hold an update like this until someone approves it (runtime.on_change: hold). A change that only shows with a real credential, or on a path the run did not reach, is not in a trace and so not in this comparison.

Is [email protected] safe to install?

KillerSkills ran it in the KillerSkills honeypot sandbox (2 scenarios; startup only; authenticated tool behavior not tested) on 2026-11-21 and scored it 84/100 (Verified). In what ran, nothing we could detect went wrong: no undeclared network egress, no credential reads, no persistent instruction writes. What it does with a real credential was not observed; the static findings and the publisher carry the rest of the score. Summary: no network, touches nothing outside the project, writes no memory.

Behavior trace

Honeypot run · 34 s · 2 scenarios · 0 deviations
t+CategoryObserved action
0.0sprocessno install scripts in bundle
14sprocessdependency install exit 0
34sclaimedstartup only: exited (0) before answering · code: 'ERR_MODULE_NOT_FOUND', url: 'file:///tmp/ks-detonate-kwMOsU/task/home/work/acme-api/.claude/skills/foundryvtt-mcp/dist/tools/handlers/actor-mutations.js' } Node.js v22.23.5
34sprocessscript backend runs setup only
34sprocessno install scripts to re-run

Static findings

HIGH
Access to sensitive file pathsdist/utils/diagnostics.js:145 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesoutput += ' 2. Check FOUNDRY_URL in your .env file\n';Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/load-env.d.ts:10 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* a `.env` in the working directory had no effect at all (#206).Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/foundry/rest-probe.js:4 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* any `.env` exists: importing `client.ts` resolves the whole config throughFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/load-env.js:2 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* Loads `.env` into `process.env` as an import side effect.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/foundry/rest-probe.d.ts:4 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* any `.env` exists: importing `client.ts` resolves the whole config throughFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
File permission modification commandpackage.json:11 · File permission modification command — agent changes file ownership/permissions"build": "tsc && chmod +x dist/index.js",Fix: Request the narrowest permission that works; replace wildcards with the exact paths or hosts.
AST05
MEDIUM
npx invocation of non-well-known packagepackage.json:38 · npx invocation of non-well-known package — may execute untrusted code"docs:serve": "npm run docs && npx http-server build/docs",Fix: Pin versions and sources; vendor anything fetched at install time.
AST06
HIGH
Access to sensitive file pathsdist/utils/diagnostics.js:175 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files'• **Update .env file** - Set FOUNDRY_API_KEY with your generated key\n' +Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
MEDIUM
npx invocation of non-well-known packagedist/index.js:201 · npx invocation of non-well-known package — may execute untrusted code// Use realpath so the comparison works when npm/npx installs the bin as aFix: Pin versions and sources; vendor anything fetched at install time.
AST06
HIGH
Access to sensitive file pathsdist/load-env.js:9 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* the entrypoint-body form validated configuration before `.env` was read, andFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
LOW
URL to a private-network addressdist/config/index.js:126 · URL to a private-network address — a LAN or development targetconsole.error(' • Network IP: http://192.168.1.100:30000');Fix: Replace encoded or assembled strings with plain literals and remove undeclared network calls.
AST07
HIGH
Access to sensitive file pathsdist/load-env.d.ts:2 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* Loads `.env` into `process.env` as an import side effect.Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/load-env.d.ts:9 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* the entrypoint-body form validated configuration before `.env` was read, andFix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/config/index.js:131 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system filesconsole.error(' • Check your environment variables and .env file');Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05
HIGH
Access to sensitive file pathsdist/load-env.js:10 · Access to sensitive file paths — SSH keys, AWS credentials, env files, or system files* a `.env` in the working directory had no effect at all (#206).Fix: Stop enumerating or reading credential locations; take secrets from a declared environment variable the user sets on purpose.
AST05

Cost to the agent

Instructions loaded
≈51 tok
1 file · 81 in bundle
Tool list per prompt
≈0 tok
0 tools · 0 per tool
Handshake
no reply
launch to tools/list, stdio
Undocumented tools
0
description under 20 chars · avg 0

Tokens estimated at four characters each. The tool list is re-read by the agent on every turn, so it is the number to compare between servers that do the same job: ranked across the index.

Known vulnerabilities

No advisories in OSV for foundryvtt-mcp@1.5.5 as of 26 min ago. This is the package itself, not its dependencies.