sutro-mcp-setup

Configure Sutro stdio MCP server connections for Cursor, Claude Code, and VS Code.

1|Updated May 11, 2026
One-click install
npx skills add https://github.com/adrianjonmiller/sutro-mcp-server --skill sutro-mcp-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sutro-mcp-setup
Source: https://github.com/adrianjonmiller/sutro-mcp-server/tree/main/skills/sutro-mcp-setup
Command: npx skills add https://github.com/adrianjonmiller/sutro-mcp-server --skill sutro-mcp-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you correctly wire the local Sutro stdio MCP server into Cursor, Claude Code, or VS Code so your editor can authenticate and call Sutro tools reliably.

Core Features & Use Cases

  • Editor MCP wiring: Configure command/args and required environment variables so the client can launch the built server.
  • Secure bundle handling: Ensure you point to the extracted security bundle directory (including required certs, JWT, and client IDs) without committing secrets.
  • Validation and live shape checking: Verify connectivity with sutro_validate_bundle and sutro_hello, then probe response shapes to keep tool parsers aligned with real API contracts.
  • Optional builder JWT refresh: Mint a short-lived builder.jwt locally using signing inputs and environment-provision scripts when needed.

Quick Start

Ask your AI assistant to guide you to set SUTRO_SECURITY_BUNDLE_DIR to your extracted security bundle path and configure your editor’s MCP server to run the built mcp/sutro/dist/index.js, then validate with sutro_validate_bundle followed by sutro_hello.

Frequently Asked Questions about sutro-mcp-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure MCP server authentication for Cursor or VS Code?

MCP server authentication for Cursor or VS Code requires setting the SUTRO_SECURITY_BUNDLE_DIR environment variable to your extracted security bundle path and configuring your editor to launch the built mcp/sutro/dist/index.js file.

What is the best way to validate Sutro MCP connectivity in my editor?

Validate Sutro MCP connectivity by running the sutro_validate_bundle tool followed by sutro_hello to verify authentication and test live response shapes against your editor's tool parsers.

Can I use a local MCP server with Claude Code without exposing my security bundle credentials?

You can use a local stdio MCP server with Claude Code securely by pointing the SUTRO_SECURITY_BUNDLE_DIR environment variable to your local bundle directory, ensuring required certs and JWTs are never committed to source control.

Why does my editor MCP tool input output mismatch across different runtime environments?

Editor MCP tool input output mismatches occur when tool parsers fall out of sync with real API contracts; probing response shapes after running sutro_hello updates parsers to align with the actual Sutro API responses.

Do I need to refresh the builder JWT for my Sutro MCP security bundle configuration?

You need to refresh the builder JWT by minting a short-lived builder.jwt locally using signing inputs and environment-provision scripts when your current authentication token expires.

How does stdio MCP server integration handle optional API base configuration?

Stdio MCP server integration handles optional API base configuration through the SUTRO_API_BASE environment variable, allowing you to override the default endpoint target during your editor setup and connectivity validation.