Iron Proxy gateway
SkillDev toolsIron Proxy gateway is a skill that routes an agent's outbound HTTP and HTTPS requests through a proxy where a human operator approves each credential request and injects the
Available today. Use it from your connected AI after setup.
No other account needed.
Have HTTP_PROXY, HTTPS_PROXY, and the Iron Proxy CA injected by NanoClaw.
Then ask your AI: use the Iron Proxy gateway skill
What your AI can do with it
- Route outbound HTTP and HTTPS requests through the session's Iron Proxy
- Hold credential requests for human approval before the proxy injects a credential
- Give the agent only a useless placeholder token instead of a real credential
- Connect accounts for an API hostname using the shared command ncl groups connect --host <A
- Let clients requiring local authentication use gateway-managed as a non-secret placeholder
- Diagnose 401 and 403 policy failures by reporting the hostname and observed error instead
Getting started
- Have HTTP_PROXY, HTTPS_PROXY, and the Iron Proxy CA injected by NanoClaw.
- Run the shared command ncl groups connect --host <API hostname> for the API hostname you want to use.
- Return the exact connect_url and describe its action; an operator_console handoff means the operator configures the credential, grant, and destination in the gateway.
- Use your requested CLI or a direct HTTP client, with gateway-managed as the placeholder where local authentication is needed.
- Verify with a credentialed request after the operator completes configuration before treating the account as connected.
What this skill tells your AI
The instructions your AI receives, as published by nanocoai/nanoclaw in .claude/skills/add-iron-proxy/payload/container/skills/iron-proxy-gateway/SKILL.md and read by ahel’s review.
Your outbound HTTP and HTTPS requests pass through your session's Iron Proxy. A policy-selected credential request waits for human approval before the proxy inserts a credential. You receive only a useless placeholder.
Policy failures
A bare 403 does not prove which layer rejected the request. It may be the destination rule, credential grant, human approval, or upstream API. Respect the block, report the hostname and observed error, and request a host-side check instead of guessing that credentials were never injected.
Connect an account
Run the shared command for the API hostname requested by the user:
ncl groups connect --host <API hostname>
Return the exact connect_url and describe its action. An operator_console
handoff requires the operator to configure the credential, grant, and destination
in the gateway; it is not an OAuth link. Do not invent a connection flow when the
result is unsupported. The command does not grant access or change policy.
Use the user's requested CLI or a direct HTTP client. Do not add an MCP server
merely to connect an account. Clients requiring local authentication may use
gateway-managed as a non-secret placeholder (for example GH_TOKEN for gh).
Never use a real token in the client. Never run a local login to store credentials.
Request approval and account connection are separate. A 401 is not proof that injection did not happen: the stored token may itself be invalid. Report the observed result, follow the shared handoff, and verify with a credentialed request after the operator completes configuration. Never claim connected before success.
Rules
- Never ask for, print, or store a raw API key or OAuth token.
- Never bypass the configured proxy or its CA validation.
- Never treat a pending approval as granted.
- Never claim a blocked destination is connected.
- Treat proxy errors as policy or operator-configuration errors, not as permission to weaken TLS.
Signals
- GitHub stars
- 31k
- Forks
- 13k
- Last commit
- Sep 2026
Questions
- Does a 403 mean my credentials were never injected?
- Not necessarily. A bare 403 may come from the destination rule, credential grant, human approval, or the upstream API. Respect the block, report the hostname and observed error, and request a host-side check instead of guessing.
- Does a 401 mean injection did not happen?
- No. The stored token may itself be invalid. Report the observed result, follow the shared handoff, and verify with a credentialed request after the operator completes configuration.
Advanced
- Catalog kind
- skill
- Key
iron-proxy-gateway- Source
- github.com/nanocoai/nanoclaw