Skip to content

fix(mcp): accept TANGLE_SANDBOX_API_KEY (canonical) with TANGLE_API_KEY fallback #48

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tangletools merged 1 commit into from
May 24, 2026
+12 −5
Merged

fix(mcp): accept TANGLE_SANDBOX_API_KEY (canonical) with TANGLE_API_KEY fallback #48

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "@tangle-network/agent-runtime",
"version": "0.20.2",
"version": "0.20.3",
"description": "Reusable runtime lifecycle for domain-specific agents.",
"homepage": "https://github.com/tangle-network/agent-runtime#readme",
"repository": {
Expand Down
15 changes: 11 additions & 4 deletions src/mcp/bin.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@
* delegate against `multiHarnessResearcherFanout`.
*
* Environment variables:
* TANGLE_API_KEY required — passed to `new Sandbox({ apiKey })`
* TANGLE_SANDBOX_API_KEY required (sandbox-scope: sk_sb_* or orch_prod_*)
* TANGLE_API_KEY fallback — accepted but expected to be a router key in product envs
* SANDBOX_BASE_URL optional — sandbox-SDK base URL override
* MCP_MAX_CONCURRENT_SANDBOXES default 4 — kernel maxConcurrency cap
* MCP_CODER_FANOUT_HARNESSES comma-separated harness ids to use for variants > 1
Expand All @@ -38,10 +39,16 @@ async function main(): Promise<void> {
const needsSandbox = wantCoder || wantResearcher
let sandboxClient: LoopSandboxClient | undefined
if (needsSandbox) {
const apiKey = process.env.TANGLE_API_KEY
// TANGLE_SANDBOX_API_KEY is the canonical sandbox-scope key. TANGLE_API_KEY
// is accepted as a fallback for parity with products that already export it
// — but in product environments TANGLE_API_KEY typically means the router
// key (sk-tan-*), which sandbox.create() will REJECT. Operators mounting
// the MCP server inside a product should set TANGLE_SANDBOX_API_KEY
// explicitly (sk_sb_* or orch_prod_*).
const apiKey = process.env.TANGLE_SANDBOX_API_KEY ?? process.env.TANGLE_API_KEY
if (!apiKey && !process.env.AGENT_RUNTIME_MCP_ALLOW_NO_KEY) {
process.stderr.write(
'agent-runtime-mcp: TANGLE_API_KEY is required (set AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 to run without it for diagnostics, or set MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to run the queue-only subset)\n',
'agent-runtime-mcp: TANGLE_SANDBOX_API_KEY is required (sandbox-scope key — sk_sb_* or orch_prod_*). TANGLE_API_KEY is accepted as a fallback. Set AGENT_RUNTIME_MCP_ALLOW_NO_KEY=1 to run without it for diagnostics, or MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to run the queue-only subset.\n',
)
process.exit(2)
}
Expand Down Expand Up @@ -85,7 +92,7 @@ async function loadSandboxClient(apiKey: string | undefined): Promise<LoopSandbo
return {
async create() {
throw new Error(
'agent-runtime-mcp: TANGLE_API_KEY is unset; coder/researcher delegations are disabled in diagnostic mode. Set TANGLE_API_KEY or use MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to remove the unsupported tools from the tool list.',
'agent-runtime-mcp: no sandbox-scope key set; coder/researcher delegations are disabled in diagnostic mode. Set TANGLE_SANDBOX_API_KEY (sk_sb_* or orch_prod_*) or TANGLE_API_KEY as a fallback, or use MCP_DISABLE_CODER=1 MCP_DISABLE_RESEARCHER=1 to remove the unsupported tools from the tool list.',
)
},
} satisfies LoopSandboxClient
Expand Down
Loading