--- name: resistance-tools-bootstrap description: Discover, install, update, connect, and troubleshoot the Resistance Tools MCP and its full Agent Skill in Codex or Claude Code. Use when an agent reaches app.resistance.dog, needs to configure Resistance Tools, or must locate the canonical operational documentation before using its tools. --- # Resistance Tools bootstrap Use this public skill only to discover and configure Resistance Tools. After setup, load the full `$resistance-tools-skill` bundled with the plugin for tool selection, workflows, verification, and user-facing result formats. Reply in the user's language. Detect whether the user runs Codex or Claude Code and show only the matching commands unless they ask for both. Never request a seed phrase, private key, wallet export, bearer token, proof, or signature. ## Keep the names distinct - Marketplace/source: `resistance-tools` - Plugin and MCP server: `resistance-tools-mcp` - Full operational Agent Skill: `resistance-tools-skill` - Remote MCP endpoint: `https://app.resistance.dog/api/mcp` The recommended plugin installation registers the MCP and installs the full Agent Skill together. There is no second skill-install command after installing the plugin. ## Fresh plugin installation Use this path when Resistance Tools is not installed yet. ### Codex ```bash codex plugin marketplace add TONresistor/resistance-tools-mcp@main codex plugin add resistance-tools-mcp@resistance-tools codex mcp login resistance-tools-mcp ``` ### Claude Code ```bash claude plugin marketplace add TONresistor/resistance-tools-mcp@main claude plugin install resistance-tools-mcp@resistance-tools claude mcp login resistance-tools-mcp ``` The login opens the native OAuth approval flow. Let the user select permissions or choose `Approve all`; never select permissions on their behalf. ## MCP-only installation Use this only when the client cannot install plugins or the user explicitly wants the tools without the full Agent Skill. ### Codex ```bash codex mcp add resistance-tools-mcp --url https://app.resistance.dog/api/mcp codex mcp login resistance-tools-mcp ``` ### Claude Code ```bash claude mcp add --transport http resistance-tools-mcp https://app.resistance.dog/api/mcp claude mcp login resistance-tools-mcp ``` State clearly that MCP-only setup does not install `$resistance-tools-skill`. Recommend the plugin path when the user wants both the tools and the complete methodology. ## Update an existing current installation Do not add the marketplace or MCP again when they already use the current names. ### Codex ```bash codex plugin marketplace upgrade resistance-tools codex plugin remove resistance-tools-mcp@resistance-tools codex plugin add resistance-tools-mcp@resistance-tools ``` ### Claude Code ```bash claude plugin marketplace update resistance-tools claude plugin update resistance-tools-mcp@resistance-tools ``` An update does not normally require another OAuth login. ## Replace the retired MCP alias Use this migration only when the configured MCP is named `resistance-tools`, an old plugin is installed under that name, or the marketplace reports a conflicting source. If an old entry is already absent, continue. Preserve an installation already named `resistance-tools-mcp`. ### Codex ```bash codex mcp logout resistance-tools codex mcp remove resistance-tools codex mcp logout resistance-tools-mcp codex mcp remove resistance-tools-mcp codex plugin remove resistance-tools@resistance-tools codex plugin remove resistance-tools-mcp@resistance-tools codex plugin marketplace remove resistance-tools codex plugin marketplace add TONresistor/resistance-tools-mcp@main codex plugin add resistance-tools-mcp@resistance-tools codex mcp login resistance-tools-mcp ``` ### Claude Code ```bash claude mcp logout resistance-tools claude mcp remove resistance-tools claude mcp logout resistance-tools-mcp claude mcp remove resistance-tools-mcp claude plugin uninstall resistance-tools@resistance-tools claude plugin uninstall resistance-tools-mcp@resistance-tools claude plugin marketplace remove resistance-tools claude plugin marketplace add TONresistor/resistance-tools-mcp@main claude plugin install resistance-tools-mcp@resistance-tools claude mcp login resistance-tools-mcp ``` ## Authentication recovery - Access tokens last 15 minutes and refresh automatically. Do not reconnect or reinstall for a normal access-token expiry. - Refresh tokens and consent last 30 days by default, or 24 hours when any sensitive permission is approved. - Concurrent Codex processes can refresh shared credentials without revoking each other's active branch. - Restart a client that retained a startup failure in memory. - Run `codex mcp login resistance-tools-mcp` or `claude mcp login resistance-tools-mcp` only for `invalid_grant`, an explicit OAuth authorization request, revoked or expired consent, or missing credentials. - After the MCP starts, call `auth.status` to verify authentication. Do not infer it from configuration output alone. ## Use the full operational skill After plugin installation, invoke `$resistance-tools-skill`. It covers Sites, TON DNS, Subdomains, Storage, wallet identity, permissions, audit, paid providers, and manually confirmed transactions. Load only its relevant bundled reference for the current task. Treat the live MCP tool schema and structured results as canonical. Every transaction tool returns a short-lived HTTPS confirmation page; the user reviews the action and confirms it manually through TON Connect. Never report a prepared request as signed, sent, confirmed, linked, minted, renewed, paid, or active before the mapped read-back proves it. Canonical sources: - Full skill: https://github.com/TONresistor/resistance-tools-mcp/blob/main/skills/resistance-tools-skill/SKILL.md - Bundled references: https://github.com/TONresistor/resistance-tools-mcp/tree/main/skills/resistance-tools-skill/references - Installation and recovery: https://github.com/TONresistor/resistance-tools-mcp#readme - MCP Registry manifest: https://github.com/TONresistor/resistance-tools-mcp/blob/main/server.json - Application: https://app.resistance.dog/