Documentation Repository
Authoritative developer reference manual for the Code Station Local Model Context Protocol (MCP) server, dual-purpose terminal CLI, 338+ client-side web tools, AI coding agent workflows, and licensing policies.
1. Quickstart & 1-Click Auto Setup
Getting StartedCode Station gives you deterministic developer tools across three interfaces: a 100% Free Web Application with 338+ client-side tools, a Local MCP Server for AI coding agents (Cursor, Claude Desktop, Windsurf), and a Dual-Purpose Terminal CLI.
npm >= 10.9. No global installation is strictly required; you can execute everything on-demand via npx -y codestation-mcp.1-Click AI Assistant Auto-Setup
Automatically detects your installed AI environments and registers the Code Station MCP server in Claude Desktop, Cursor IDE, and Windsurf in a single command:
npx -y codestation-mcp setup --key CS-PRO-YOUR-KEYOr configure with the Free tier (all standard tools enabled):
npx -y codestation-mcp setupGlobal CLI Installation (Optional)
To make the short command codestation or codestation-mcp globally accessible in your terminal without typing npx:
npm install -g codestation-mcp2. Terminal Developer CLI & Unix Piping
CLI Power EngineThe codestation-mcp binary is engineered to be dual-purpose: when invoked with subcommands, it behaves as an ultra-fast terminal utility with exit codes, formatted colors, and Unix pipe support.
stdin. For instance, cat request.curl | npx codestation-mcp curl --target go or cat data.json | npx codestation-mcp ts Profile.# General Syntax
npx codestation-mcp <command> [input_or_file] [flags]
# Or with global install
codestation <command> [input_or_file] [flags]3. cURL to Any Language (curl / curl-to-code)
Terminal SubcommandConverts raw cURL commands into clean, idiomatic client code for TypeScript fetch, Axios, Python requests, and Go net/http. Handles query parameters, headers (-H), custom HTTP methods (-X POST/PUT/PATCH/DELETE), JSON payloads (-d, --data-raw), and basic authentication (-u).
curl <command> [--target <lang>]PRO TIERnpx codestation-mcp curl 'curl -X POST https://api.stripe.com/v1/charges -u sk_test_123: -d "amount=2000¤cy=usd"' --target fetchnpx codestation-mcp curl 'curl https://api.github.com/user -H "Authorization: Bearer ghp_token"' --target pythonnpx codestation-mcp curl 'curl -X PUT https://api.example.com/items/42 -H "Content-Type: application/json" -d "{\"active\":true}"' --target go| Flag / Argument | Type | Default | Description |
|---|---|---|---|
<curl_command> | String / stdin | Required | The raw curl string to parse, or piped from stdin. |
--target, -t | String | fetch | Target language/client: fetch, axios, python, go. |
4. Secret Leak Scanner & Drift Auditor (env / env-audit)
Security SubcommandScans .env files or strings for accidental credential leaks and synchronizes with .env.example. Detects live Stripe keys, AWS access keys, OpenAI tokens, GitHub PATs, private keys, and high-entropy secrets. Outputs a clean security audit report with automatic credential redaction (e.g. sk_l••••••••5678).
env [path] [--example [path]]PRO TIERnpx codestation-mcp env .env --example .env.examplenpx codestation-mcp env-audit --input "STRIPE_SECRET=sk_live_51Mszabcdef1234567890"npx codestation-mcp env in terminal recordings, CI/CD logs, or live demonstrations.| Secret Pattern | Severity | Prefix / Format Detected |
|---|---|---|
| Stripe Secret Key | Critical | sk_live_... (live billing credentials) |
| AWS Access Key | Critical | AKIA... / ASIA... (20-character AWS credentials) |
| OpenAI API Key | Critical | sk-proj-... / sk-... (OpenAI project & user keys) |
| GitHub Personal Token | Critical | ghp_..., github_pat_... |
| Private Key PEM | Critical | -----BEGIN RSA/OPENSSH PRIVATE KEY----- |
| Missing .env.example Key | High | Keys required by .env.example missing from active .env |
5. Realistic Mock Data & SQL Seeder (mock / mock-data)
Data GeneratorGenerates realistic, developer-friendly mock datasets and SQL INSERT statements for unit tests, seeding databases, or prototyping frontends. Includes prebuilt templates (users, products, orders) and supports custom JSON schemas.
mock [template] [--count N] [--format json|sql]PRO TIERnpx codestation-mcp mock users --count 5npx codestation-mcp mock users --count 10 --format sql --table app_usersnpx codestation-mcp mock-data --schema '{"id":"uuid","fullName":"name","workEmail":"email","cost":"price"}' --count 3| Flag | Options | Default | Description |
|---|---|---|---|
template | users, products, orders | users | Built-in domain template for quick realistic generation. |
--count, -c | Integer (1-500) | 5 | Number of records to generate. |
--format, -f | json, sql | json | Output serialization format. |
--table, -t | String | template name | Target table name when formatting as SQL INSERT. |
--schema, -s | JSON String | Optional | Custom schema mapping field names to data types. |
6. Git Merge Conflict Resolver (conflict / conflict-parse)
Git SubcommandParses standard Git merge conflict markers (<<<<<<< HEAD, =======, >>>>>>> branch) and executes clean resolution strategies without touching your Git index or leaving residual syntax errors.
conflict <file> [--strategy ours|theirs|both]PRO TIERnpx codestation-mcp conflict ./src/config.ts --strategy oursnpx codestation-mcp conflict ./src/config.ts --strategy theirscat << 'EOF' | npx codestation-mcp conflict-parse --strategy both
<<<<<<< HEAD
const API_URL = "https://api-v1.com";
=======
const API_URL = "https://api-v2.com";
>>>>>>> main
EOF| Strategy | Behavior |
|---|---|
ours | Keeps code from the top block (HEAD); strips conflict markers and incoming block. |
theirs | Keeps code from the bottom block (incoming branch); strips conflict markers and current block. |
both | Preserves both blocks sequentially in the resolved file; removes markers. |
7. JWT Token Inspector (jwt)
Terminal SubcommandInspects JSON Web Tokens in your terminal instantly without sending tokens over the internet to unverified websites. Decodes Header and Payload claims, calculates exact expiration dates, and shows remaining time-to-live (TTL).
jwt <token>PRO TIERnpx codestation-mcp jwt eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkphbmUgRG9lIiwiZXhwIjoxNzY3MjI1NjAwfQ.test8. SQL Formatter & Dialects (sql)
Database SubcommandFormats messy SQL queries with dialect-aware indentation, keyword capitalization, and clause alignment across PostgreSQL, MySQL, SQLite, and SQL Server.
sql "<query>" [--dialect <name>]PRO TIERnpx codestation-mcp sql "select id, name, created_at from users where status = 'active' order by created_at desc;" --dialect postgresql9. Cron Schedule Translator (cron)
Date/Time SubcommandTranslates 5-field Unix cron syntax into clear, unambiguous English and computes the next 5 execution timestamps.
cron "<expression>"PRO TIERnpx codestation-mcp cron "0 9 * * 1-5"10. Cryptographic Hashes & Digests (hash)
Crypto SubcommandComputes cryptographic digests using native Node.js WebCrypto. Supports SHA-256, SHA-512, MD5, SHA-1, and CRC-32.
hash "<text>" [--alg <name>]PRO TIERnpx codestation-mcp hash "developer-secret-token" --alg sha25611. JSON to TypeScript & Zod Schema (ts / zod)
Code GenerationInfers production-ready TypeScript types and runtime Zod validation schemas directly from sample JSON payloads or API responses.
ts <json> [RootName] / zod <json> [SchemaName]PRO TIERnpx codestation-mcp ts '{"id":101,"name":"Alice","roles":["admin","editor"]}' Usernpx codestation-mcp zod '{"id":101,"name":"Alice","roles":["admin","editor"]}' userSchema12. UUID Generator & JSON Formatter (uuid / json)
Free Core UtilitiesEveryday terminal essentials available completely free on both CLI and MCP.
uuid [count] / json <raw>FREE TIERnpx codestation-mcp uuid 3npx codestation-mcp json '{"status":"ok","count":42}'13. Model Context Protocol (MCP) Stdio Architecture
Protocol SpecsThe Code Station MCP server communicates with AI clients over standard input/output (stdio) using the JSON-RPC 2.0 protocol mandated by the Model Context Protocol specification.
tools/list(Standard MCP): Returns array of available tools and JSON Schema parameter descriptors.tools/call(Standard MCP): Executes a tool with provided arguments and returns content payloads.tools.list(Extended RPC): Lightweight array of tool identifiers.tools.describe(Extended RPC): Returns full documentation for a specific tool ID.auth.status(Extended RPC): Returns current license tier, key fingerprint, and device status.entitlements.status(Extended RPC): Detailed feature entitlement flags.
node ./bin/codestation-mcp.mjs --key CS-PRO-YOUR-KEY14. AI Assistant Configuration Guides
Integration SetupConnect Code Station to your favorite AI development environment in seconds.
Claude Desktop
Add to your Claude configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"codestation": {
"command": "npx",
"args": ["-y", "codestation-mcp", "--key", "CS-PRO-YOUR-KEY"]
}
}
}Cursor IDE
Add to your project's .cursor/mcp.json or paste into Cursor Settings (Settings → Features → MCP):
{
"mcpServers": {
"codestation": {
"command": "npx",
"args": ["-y", "codestation-mcp", "--key", "CS-PRO-YOUR-KEY"]
}
}
}Windsurf / Codeium
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"codestation": {
"command": "npx",
"args": ["-y", "codestation-mcp", "--key", "CS-PRO-YOUR-KEY"]
}
}
}Claude Code CLI
Register directly using Claude Code's built-in MCP manager:
claude mcp add codestation npx -y codestation-mcp --key CS-PRO-YOUR-KEY15. Copy-Pastable AI System Prompt & Rules
Agent PromptingAdd this block to your assistant's Custom Instructions, .cursorrules, or CLAUDE.md. It instructs the LLM to delegate calculations, conversions, and parsing directly to local Code Station tools:
# Code Station MCP Assistant Guidelines
You have access to the Code Station MCP developer server (codestation-mcp).
Always prioritize calling these local, deterministic tools instead of calculating, parsing, or formatting in your internal reasoning:
1. cURL to Code: Call codestation_curl_to_code to convert cURL commands into clean TypeScript fetch/axios, Python requests, or Go net/http.
2. Environment Security: Call codestation_env_audit to scan .env files for live secret leaks (Stripe, AWS, OpenAI, GitHub PAT, private keys) and synchronize with .env.example.
3. Realistic Mock Data: Call codestation_mock_data to generate realistic test data and SQL INSERT seed statements.
4. Git Conflict Resolution: Call codestation_git_conflict to parse merge conflict markers and resolve cleanly with ours, theirs, or both.
5. JSON to TypeScript & Zod: Call codestation_json_to_typescript and codestation_json_to_zod to generate production-ready types and Zod schemas from API payloads or sample data.
6. SQL Formatting & Execution: Call codestation_format_sql to format queries across PostgreSQL, MySQL, SQLite, and SQL Server. Use codestation_run_sql for in-memory execution.
7. JWT Decoding: When inspecting JSON Web Tokens, call codestation_jwt_decode to inspect headers, claims, and expiry dates without guessing.
8. Cron Schedules: Call codestation_cron_explain to understand complex cron patterns and project future executions.
9. Timezones & Business Days: Always call codestation_timezone_convert and codestation_business_days for date arithmetic rather than calculating manually.
10. Hashes & Signatures: Call codestation_hash and codestation_hmac for cryptographic digests (SHA-256, SHA-512, MD5).
11. Regex Testing: Call codestation_regex_test to verify regular expressions and return match groups.
12. Text Transformations: Use codestation_case_convert, codestation_text_diff, and codestation_uuid for RFC 4122 v4 UUIDs.16. Complete MCP Tool Capability Matrix
Tool CatalogOverview of all 20+ Model Context Protocol tools exposed by codestation-mcp:
| MCP Tool Name | Tier | Description |
|---|---|---|
codestation_curl_to_code | Pro | Converts cURL commands into TypeScript fetch/axios, Python, or Go. |
codestation_env_audit | Pro | Scans .env for secrets (Stripe, AWS, OpenAI, GitHub PAT) & audits .env.example. |
codestation_mock_data | Pro | Generates realistic mock datasets & SQL INSERT statements. |
codestation_git_conflict | Pro | Parses & resolves Git merge conflicts with ours, theirs, or both. |
codestation_json_to_typescript | Pro | Generates clean, nested TypeScript interfaces from sample JSON. |
codestation_json_to_zod | Pro | Generates production-ready Zod schema declarations and inferred types. |
codestation_jwt_decode | Pro | Decodes JWT headers, claims, and calculates expiry TTL. |
codestation_format_sql | Pro | Beautifies SQL queries for PostgreSQL, MySQL, SQLite, and SQL Server. |
codestation_cron_explain | Pro | Translates Unix cron expressions and projects next 5 runtimes. |
codestation_hash | Pro | Cryptographic hashing (SHA-256, SHA-512, MD5, SHA-1, CRC-32). |
codestation_hmac | Pro | Keyed HMAC message authentication (SHA-256, SHA-512). |
codestation_business_days | Pro | Calculates business working days between two dates excluding weekends/holidays. |
codestation_regex_test | Pro | Tests regular expressions and extracts capture groups. |
codestation_json_schema | Pro | Infers Draft 7 or 2020-12 JSON Schema structures from sample data. |
codestation_format_json | Free | Formats and pretty-prints JSON payloads. |
codestation_minify_json | Free | Compacts JSON into single-line representations. |
codestation_json_to_yaml | Free | Converts JSON data into YAML syntax. |
codestation_yaml_to_json | Free | Parses YAML into standard JSON. |
codestation_base64 | Free | Standard and URL-safe Base64 encode and decode. |
codestation_case_convert | Free | Converts identifiers between camelCase, snake_case, kebab-case, PascalCase. |
codestation_text_diff | Free | Unified line-by-line semantic text comparison. |
codestation_uuid | Free | Generates cryptographically random RFC 4122 v4 UUIDs. |
17. Web Application & 15 Stations Directory
Web ApplicationEvery single one of the 338+ developer tools on the Code Station web application (codestation.in) is 100% free, unlimited, and runs client-side.
1. JSON & Data Station
Formatting, validation, JSON-to-YAML, JSON-to-CSV, and schema validation.
Open Station →2. Security & Crypto Station
Cryptographic hashes, HMACs, JWT decoders, key generators, and password entropy.
Open Station →3. API & Webhooks Station
Mock payload generators, cURL generator, query parsers, and HTTP status codes.
Open Station →4. SQL & Database Station
SQL formatters, mock data seeder, ER diagram generators, and dialect converters.
Open Station →6. Date & Time Station
Timezone conversions across IANA databases, business day calculators, and timestamps.
Open Station →7. Text & Strings Station
Case conversion, semantic text diffing, line sorting, and deduplication.
Open Station →8. Converters Station
Two-way number base conversion, temperature, and unit converters.
Open Station →9. Image & SVG Station
PNG/JPEG compression, SVG optimizer, aspect ratio tools, and color palette extraction.
Open Station →10. Regular Expressions Station
Regex tester, regex explainer, and match capture group visualizer.
Open Station →11. Markdown Station
Live Markdown to HTML rendering, tables formatter, and clean editor.
Open Station →12. Spreadsheet & CSV Station
CSV to JSON, Excel XLSX viewer, delimiter converter, and table viewer.
Open Station →13. Cron & Schedules Station
Interactive cron editor, next run prediction, and plain English descriptions.
Open Station →14. Color & CSS Station
HEX/RGB/HSL conversion, CSS shadow generator, and contrast checker.
Open Station →18. Pro Licensing & Anti-Sharing Device Binding
Licensing ArchitectureCode Station Pro is priced accessibly and operates with a login-free architecture. Users receive an instant cryptographic key (e.g., CS-PRO-XXXX-XXXX-XXXX) without passwords or accounts.
India Pricing (Razorpay)
₹199 / month or ₹999 one-time lifetime license.
Supports UPI (Google Pay, PhonePe, Paytm), Debit/Credit Cards, NetBanking.
Global Pricing
$2.99 / month or $19.00 one-time lifetime license.
International Cards, PayPal, and digital wallets.
Device Binding Rules (3-Device Limit)
- 3 Active Devices: Each Pro key can be bound to up to 3 developer machines (e.g., workstation, laptop, home PC).
- Hardware Fingerprinting: Machines register a unique local hardware fingerprint with the license service.
- Automatic 30-Day Pruning: Inactive machines are automatically purged after 30 days to free up slots.
- Self-Service Reset: Easily unbind your machines using the Reset Active Devices button on the Pro page.
- Offline Caching: Validated license status is cached locally in
~/.codestation/license.json, enabling seamless offline work.
19. Lost Key Recovery Policy & Fee Schedule
Policy & RecoveryBecause Code Station is 100% login-free, plaintext keys are never stored on our servers. Cloudflare edge KV stores only one-way cryptographic SHA-256 hashes (`lic_...`). As a result, lost keys cannot be viewed or retrieved from a database.
- Send an email to twnspace2@gmail.com.
- Include your proof of purchase: your Razorpay Payment ID (
pay_...) or a screenshot of your payment receipt. - Our team verifies the payment ID, immediately revokes the old SHA-256 hash in Cloudflare KV, generates a fresh replacement key, and emails it back to you.
To discourage public key leakages and unauthorized sharing while providing legitimate purchasers a guaranteed recovery path, a progressive fee applies to regenerated keys:
- 1st Key Regeneration: ₹25
- 2nd Key Regeneration: ₹50 (2×)
- 3rd Key Regeneration: ₹100 (2×)
- 4th Key Regeneration: ₹200 (2×)
- Subsequent Regenerations: Doubles each time (*2).
20. Zero-Telemetry & Privacy Architecture
Security SpecsCode Station is designed from the ground up for strict privacy, corporate compliance, and confidentiality.
Zero Analytics & Zero Tracking
No tracking cookies, no Google Analytics, no session recorders, and no third-party CDN telemetry. Your workflow is completely private.
Client-Side In-Memory Execution
On the web, tools execute in WebAssembly and WebCrypto within your browser memory. Data never leaves your machine.
Zero-Knowledge Licensing
License keys are stored as one-way SHA-256 hashes (`lic_...`) at Cloudflare edge KV. Server compromises cannot expose plaintext user keys.
Local Terminal & Stdio Privacy
The CLI and MCP server process everything locally in your Node.js runtime without external proxy requests.
21. Troubleshooting, Common Errors & FAQs
Help & FAQsQ: Error "Node.js version is not supported"
Code Station requires Node.js 22.13.0 or higher. Check your current version with node -v. If you are using nvm, switch by running nvm use 22 or install Node 22 via nvm install 22.
Q: Claude Desktop or Cursor does not show Code Station tools
1. Verify that your configuration file contains valid JSON.
2. Ensure you ran npx -y codestation-mcp setup.
3. Completely quit and restart Claude Desktop or Cursor (hot reload does not always pick up newly registered stdio MCP servers).
4. Verify you have network access to download the package or run npm install -g codestation-mcp to keep it cached locally.
Q: Can I use Code Station completely offline?
Yes! Both the web application and CLI are built offline-first. The web application includes a 151-asset Service Worker manifest cached locally. The CLI caches your active license in ~/.codestation/license.json, enabling uninterrupted usage on flights and off-grid environments.
Q: Are web tools really 100% free forever?
Yes. All 338+ developer tools accessible on codestation.in are completely free, unrestricted, and have zero paywalls. Pro licensing is exclusively required for local AI agents via the MCP stdio protocol and advanced terminal subcommands.