Interactive Wizard
The MCP Generator includes an interactive wizard for guided configuration. The wizard activates when you run stellar mcp generate with no flags.
Starting the Wizard
stellar mcp generateWizard Flow
The wizard guides you through 7 configuration steps:
Contract ID
Enter the contract ID of your deployed Soroban contract.
🚀 Enter the contract ID (starts with 'C', 56 characters):
> CBX7HKQ6WIOYAHS6SLL7Y3MRPTYOSGJTDL6XXYYOTEWEN3PRGK3DSVZGValidation:
- Must be exactly 56 characters
- Must start with ‘C’
- Must be valid base32 encoding
Network Selection
Select the network where your contract is deployed.
🌐 Select the network:
> testnet
mainnet
futurenet
local
customIf you select custom, you’ll be prompted for:
- Custom RPC URL
- Network passphrase
Language Selection
Choose your target language.
💻 Select the target language:
> typescript
pythonFrontend Generation
Choose whether to generate a web frontend.
⚙️ Generate a React frontend alongside the MCP server?
> No - MCP server only
Yes - Generate React frontendOutput Directory
Specify where to generate the project.
📁 Enter output directory:
> ./my-token-mcpDefault: ./mcp-server
Contract Name (Optional)
Optionally provide a name for your contract.
📝 Enter contract name (optional, press Enter to skip):
> my-tokenIf skipped, the generator attempts to:
- Read the name from contract metadata
- Use the first 8 characters of the contract ID
MCP Server Name
Set the name for MCP server registration.
🏷️ Enter MCP server name:
> soroban-contractDefault: soroban-contract
Configuration Summary
After answering all prompts, the wizard shows a summary:
╔═══════════════════════════════════════════════════════════╗
║ Configuration Summary ║
╠═══════════════════════════════════════════════════════════╣
║ Contract ID: CAHLJEQUCNTV7JPAPCMLCBIHOX7FFB57DUARJ... ║
║ Network: testnet ║
║ Language: typescript ║
║ Output: ./my-token-mcp ║
║ Contract Name: my-token ║
║ Server Name: soroban-contract ║
╚═══════════════════════════════════════════════════════════╝
Continue with generation? [Y/n]Visual Features
The wizard uses color-coded output:
| Color | Purpose |
|---|---|
| Cyan | Headers and section titles |
| Green | Success messages and confirmations |
| Yellow | Warnings and important notes |
| Red | Errors and validation failures |
Emoji Support
The wizard displays emojis with ASCII fallbacks:
| Emoji | Fallback | Usage |
|---|---|---|
| 🚀 | > | Start/action prompts |
| ✨ | * | Success indicators |
| 📁 | [] | Directory/file references |
| ⚙️ | [*] | Configuration options |
| ✅ | [OK] | Completed steps |
| ℹ️ | i | Information |
Keyboard Navigation
| Key | Action |
|---|---|
↑ / ↓ | Navigate options |
Enter | Select / Confirm |
Ctrl+C | Cancel wizard |
Backspace | Clear input |
Examples
Full Wizard Session
$ stellar mcp generate
═══════════════════════════════════════════════════════════
Stellar MCP Generator Wizard
═══════════════════════════════════════════════════════════
This wizard will guide you through generating an MCP server
from a deployed Soroban contract.
🚀 Ready to begin? [Y/n] Y
Step 1/7: Contract ID
━━━━━━━━━━━━━━━━━━━━━
🔗 Enter the contract ID (starts with 'C', 56 characters):
> CBX7HKQ6WIOYAHS6SLL7Y3MRPTYOSGJTDL6XXYYOTEWEN3PRGK3DSVZG
✅ Contract ID validated
Step 2/7: Network
━━━━━━━━━━━━━━━━━
🌐 Select the network:
▸ testnet
mainnet
futurenet
local
custom
✅ Network: testnet
Step 3/7: Language
━━━━━━━━━━━━━━━━━━
💻 Select the target language:
▸ typescript
python
✅ Language: typescript
Step 4/7: Frontend Generation
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚙️ Generate a React frontend alongside the MCP server?
▸ No - MCP server only
Yes - Generate React frontend
✅ Frontend: No
Step 5/7: Output Directory
━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Enter output directory [./mcp-server]:
> ./my-token-mcp
✅ Output: ./my-token-mcp
Step 6/7: Contract Name (Optional)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 Enter contract name (press Enter to skip):
> my-token
✅ Name: my-token
Step 7/7: Server Name
━━━━━━━━━━━━━━━━━━━━━
🏷️ Enter MCP server name [soroban-contract]:
>
✅ Server name: soroban-contract
═══════════════════════════════════════════════════════════
🚀 Generating MCP server...
✅ Fetched contract specification
✅ Generated TypeScript code
✅ Created project files
✅ Generated Stellar bindings
✨ MCP server generated successfully!
📁 Output: ./my-token-mcp
Next steps:
cd my-token-mcp
pnpm install
pnpm build
pnpm startWhen to Use Wizard vs Flags
| Scenario | Recommended |
|---|---|
| First time using the generator | Wizard |
| Exploring options | Wizard |
| CI/CD automation | Flags |
| Scripted generation | Flags |
| Quick iteration | Flags |
Disabling Wizard
To always use flags mode, provide at least the required --contract-id:
# This will NOT trigger the wizard
stellar mcp generate --contract-id CABC...
# This WILL trigger the wizard
stellar mcp generateLast updated on