{"_id":"@coddieapp/mcp-server","_rev":"7-e06e08c0027d0d46986d90bb0b490b02","name":"@coddieapp/mcp-server","dist-tags":{"latest":"1.0.7"},"versions":{"1.0.0":{"name":"@coddieapp/mcp-server","version":"1.0.0","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.0","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"ab849444768bda45cb9a1b07ad6e01379425a515","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":10,"integrity":"sha512-p88qR67f61lwV3XixXS9/vDQRE4ad5JrtvS5pSh+S8Z0OBcFdDQ4uLyJc6JJEFciebjofbig2+8/0MoRxnCRKQ==","signatures":[{"sig":"MEYCIQCOJZHZ/VRpEyThBpXPrpmIC0zjJjm4cDlsOIS5cCBnKwIhAPuC0+JVNFaz5muP9unvEmqfyxQzM5qjyCH7pEFgQYme","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20181},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"b8a0608af0042cae49a3d48e5ac4a48989a2f3c9","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1753033445869_0.2006744099129789","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@coddieapp/mcp-server","version":"1.0.1","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.1","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"mcp-server":"build/index.js"},"dist":{"shasum":"15f4a48f4962701847c2cd3ddb0b1615ec0aa084","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":10,"integrity":"sha512-D1gCV+VkPayZPDBbtvCasiiDmvdIuuWduwDNmdG0TW8F5hAqfn4fOBevtdtUH41EdeTWkw1g07ITyUgwjPvrqA==","signatures":[{"sig":"MEUCIQCzWjGFUYKNs0HzBxi50Dfb+F4GUcrCPg2Uv2zuZLVkAwIgA/YMpN3hApQxDo3wHC/QWMUoUxwkZzaGL4fRmCPLGYc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20181},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"b8a0608af0042cae49a3d48e5ac4a48989a2f3c9","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1753034701823_0.8385924683987938","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@coddieapp/mcp-server","version":"1.0.3","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.3","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"coddie-mcp":"build/index.js"},"dist":{"shasum":"10b4bd3c32684c4be9e3b49b9bd925ec0d780aa4","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.3.tgz","fileCount":10,"integrity":"sha512-h1dYxLGnXjKl7MIfQb5u3XxS3/hIEQiWcoB4Sw6xKF3QUpzA2HljxGLr5BgrSIrACP4Hh9lyKQRFyZkouuNtTw==","signatures":[{"sig":"MEYCIQCYHQnfoe6K8NeWqpj54D44S+/w9PirWBhqRDZuE9t1dwIhAIGJfL5GIJvoB7V89Wa7AZecn8VBfy67wLc42qe21Ovp","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20204},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"0d79b08d498ca74c7e156629b98882e8e0b042be","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.3_1753047839586_0.5011729921630428","host":"s3://npm-registry-packages-npm-production"}},"1.0.4":{"name":"@coddieapp/mcp-server","version":"1.0.4","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.4","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"coddie-mcp":"build/index.js"},"dist":{"shasum":"93522f88484c0faea7b3cdacb9c5995ef3ff7ad8","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.4.tgz","fileCount":10,"integrity":"sha512-Uq3qaSM0BwU8h3s4iGL84P3dS1RWlK5vmZ1ze54vGF7HJlysSqvaH1JC/IQPuFdMUnsqN976Dnv93+QWEZEZuw==","signatures":[{"sig":"MEYCIQDDNu2JYuK5aTExPL2xbzpvXQrClRR5ZKNSbenXmjm8iwIhANBLem/6m5IualRkSXNt5dqecX39R3PGPMpoLSP68RmI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":20199},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"0d79b08d498ca74c7e156629b98882e8e0b042be","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.4_1753068503585_0.6411511562556707","host":"s3://npm-registry-packages-npm-production"}},"1.0.5":{"name":"@coddieapp/mcp-server","version":"1.0.5","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.5","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"coddie-mcp":"build/index.js"},"dist":{"shasum":"576b5e9e56586f8459a95a977171e91e7a5d8753","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.5.tgz","fileCount":11,"integrity":"sha512-Hu++Ur2ICvmCUQB9DXiYztI5EvflRsiLwLAfH7pbscwiXAMUlNtpIG1KHZL5bdur+q+ctmgbCm88E9Fh/hBraw==","signatures":[{"sig":"MEUCIQCRCX+FJTznpj1UNV99rz11pTXr7r9TKw8OzLUJ50W4lgIgHM6G9JVrQSRUs42ataYR4XcQulVyKuYv7alBttXnwo8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":25123},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"1802f0a83931a7aa8406d13da3c1c76fed731258","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.5_1753206225823_0.6679408699253515","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@coddieapp/mcp-server","version":"1.0.6","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","_id":"@coddieapp/mcp-server@1.0.6","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"bin":{"coddie-mcp":"build/index.js"},"dist":{"shasum":"389a37c6604c9752b0de564a50aab25081030025","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.6.tgz","fileCount":11,"integrity":"sha512-aB7DWI/RdDCGLdFXOi+niDNPs/VVoyfFwCV/xIGfRko0WIvzhF5EOhqYqlcREaJXdtP3AnPireU3yfmMxFg46w==","signatures":[{"sig":"MEUCIQDgVYA21CCYwibeDUd8Ul2ABirgoslUbUuujLb9tPvrrQIgcXykponjtqqp//3TmdYdRwF0z6mgCsLmB+zJx3uSrdA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26808},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"aa916ed05a6333566abb7d6f8c16df27aba73cbe","scripts":{"dev":"tsc && node build/index.js","build":"tsc","clean":"rimraf build","prepublishOnly":"npm run build"},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"repository":{"url":"git+https://github.com/coddieapp/mcp-server.git","type":"git"},"_npmVersion":"11.1.0","description":"MCP server for Coddie project planning application","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^3.25.76","@modelcontextprotocol/sdk":"^1.16.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"rimraf":"^6.0.1","typescript":"^5.8.3","@types/node":"^24.0.14"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.6_1753237610847_0.8022590933000655","host":"s3://npm-registry-packages-npm-production"}},"1.0.7":{"name":"@coddieapp/mcp-server","version":"1.0.7","description":"MCP server for Coddie project planning application","type":"module","bin":{"coddie-mcp":"build/index.js"},"scripts":{"build":"tsc","dev":"tsc && node build/index.js","prepublishOnly":"npm run build","clean":"rimraf build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.16.0","zod":"^3.25.76"},"devDependencies":{"@types/node":"^24.0.14","rimraf":"^6.0.1","typescript":"^5.8.3"},"keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"author":{"name":"Coddie"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/coddieapp/mcp-server.git"},"homepage":"https://coddie.dev","bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@coddieapp/mcp-server@1.0.7","gitHead":"6143a5de0099fc3dadfa6c3cadd1359aaf1214af","_nodeVersion":"22.14.0","_npmVersion":"11.1.0","dist":{"integrity":"sha512-V90LdIhNOd6BLgc2x+oUGQ8MFgJxpfoJPElOgC9BziRaSh42L4M41zf1vY6Pc7rw+BTRrEI6n0SSIMsi1+X/ew==","shasum":"16fc5b10257808e3f0260f0c3a0e126c5f5d442f","tarball":"https://registry.npmjs.org/@coddieapp/mcp-server/-/mcp-server-1.0.7.tgz","fileCount":11,"unpackedSize":26127,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDGbRNOn7Glv0khl8d/xyxj/N4aiZDy9ik1WaaPp9m2kAiEAprMs55yNIm75SnFYyZaNJBxWrB+rUMZjcf7eyPqGU+0="}]},"_npmUser":{"name":"coddieapp","email":"christianaime@coddie.dev"},"directories":{},"maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.7_1753275602868_0.08626799863580437"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-20T17:44:05.767Z","modified":"2025-07-23T13:00:03.201Z","1.0.0":"2025-07-20T17:44:06.047Z","1.0.1":"2025-07-20T18:05:02.016Z","1.0.3":"2025-07-20T21:43:59.783Z","1.0.4":"2025-07-21T03:28:23.766Z","1.0.5":"2025-07-22T17:43:46.006Z","1.0.6":"2025-07-23T02:26:51.070Z","1.0.7":"2025-07-23T13:00:03.044Z"},"bugs":{"url":"https://github.com/coddieapp/mcp-server/issues"},"author":{"name":"Coddie"},"license":"MIT","homepage":"https://coddie.dev","keywords":["mcp","model-context-protocol","coddie","project-planning","ai-assistant","claude","cursor","windsurf"],"repository":{"type":"git","url":"git+https://github.com/coddieapp/mcp-server.git"},"description":"MCP server for Coddie project planning application","maintainers":[{"name":"coddieapp","email":"christianaime@coddie.dev"}],"readme":"# Coddie MCP Server\r\n\r\nA Model Context Protocol (MCP) server that provides AI assistants with **secure, read-only access** to your [Coddie](https://coddie.dev) project planning data. This allows AI assistants like Claude, Cursor, and Windsurf to help you work with your existing projects, development phases, implementation steps, and project rules.\r\n\r\n## What is Coddie?\r\n\r\n**Coddie** is a SaaS project planning application that helps developers transform ideas into structured, production-ready development plans. It uses an interactive 4-step planning process and generates comprehensive PRD documents, development phases, and actionable implementation steps focused on Next.js + TypeScript + Supabase applications.\r\n\r\n## Prerequisites\r\n\r\n- Node.js (version 18 or higher)\r\n- A [Coddie](https://coddie.dev) account with existing projects\r\n- API key from your Coddie account settings\r\n\r\n## Setup\r\n\r\n### 1. Get Your Coddie API Key\r\n\r\n1. Log in to your [Coddie account](https://coddie.dev)\r\n2. Navigate to **Settings** → **API Keys**  \r\n3. Generate a new API key for MCP access\r\n4. Copy the generated API key (you'll need it for configuration)\r\n\r\n### 2. Configure Your AI Assistant\r\n\r\n#### Claude Desktop\r\n\r\nAdd this to your Claude Desktop configuration file:\r\n\r\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\r\n**Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"coddie\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\r\n        \"-y\",\r\n        \"@coddieapp/mcp-server@latest\",\r\n        \"--api-key\",\r\n        \"your_coddie_api_key_here\"\r\n      ]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n#### Other AI Assistants\r\n\r\nFor **Cursor** or **Windsurf**, follow their respective MCP configuration documentation using the same command structure above.\r\n\r\n### 3. Restart Your AI Assistant\r\n\r\nAfter updating the configuration file, restart your AI assistant to load the Coddie MCP server.\r\n\r\n## Security Considerations\r\n\r\n⚠️ **Important Security Notes:**\r\n\r\n- **Read-only access**: This MCP server provides read-only access to your Coddie data\r\n- **API key security**: Keep your API key secure and don't share it publicly\r\n- **Project scoping**: The server only accesses projects belonging to your authenticated account\r\n- **Review tool calls**: Always review what the AI assistant is requesting before allowing tool execution\r\n\r\n## Available Tools\r\n\r\nThe Coddie MCP server provides these tools to AI assistants:\r\n\r\n### Project Management\r\n- **`list_projects`** - List all your Coddie projects\r\n- **`get_project_info`** - Get detailed project information (name, description, tech stack, status)\r\n- **`get_context`** - Get development progress and context summary for a project\r\n\r\n### Features & Planning\r\n- **`list_features`** - List all features for a specific project\r\n\r\n### Development Phases\r\n- **`list_phases`** - List all development phases for a project\r\n- **`get_phase`** - Get detailed phase information (title, description, status)\r\n- **`list_steps`** - List all implementation steps for a specific phase  \r\n- **`get_step`** - Get detailed step information (content, code examples, completion status)\r\n\r\n### Project Rules\r\n- **`list_rules`** - List all rules for a specific project\r\n- **`get_rule`** - Get detailed rule information (file patterns, content, descriptions)\r\n\r\n## Example Usage\r\n\r\nOnce configured, you can ask your AI assistant questions like:\r\n\r\n- *\"What projects do I have in Coddie?\"*\r\n- *\"Show me the current phase for my e-commerce project\"*\r\n- *\"What implementation steps are left in the authentication phase?\"*\r\n- *\"What are the coding rules for my SaaS project?\"*\r\n\r\n## Troubleshooting\r\n\r\n### \"API key is required\" error\r\n- Ensure you've added the `--api-key` argument to your configuration\r\n- Verify your API key is correct and not expired in Coddie settings\r\n\r\n### \"HTTP error! status: 401\" \r\n- Your API key may be invalid or revoked\r\n- Generate a new API key in your Coddie account settings\r\n\r\n### Connection issues\r\n- Ensure you have an active internet connection\r\n- Check that you can access coddie.dev in your browser\r\n- Restart your AI assistant after configuration changes\r\n\r\n## Contributing\r\n\r\nThis MCP server is open source. Feel free to submit issues and pull requests on [GitHub](https://github.com/coddieapp/mcp-server).\r\n\r\n## Support\r\n\r\n- **Documentation**: [Coddie Help Center](https://coddie.dev/help)\r\n- **Issues**: [GitHub Issues](https://github.com/coddieapp/mcp-server/issues)\r\n- **Contact**: [support@coddie.dev](mailto:support@coddie.dev)\r\n\r\n---\r\n\r\n**Note**: This MCP server requires an active Coddie account and existing projects to be useful. If you're new to Coddie, [sign up](https://coddie.dev) and create your first project!","readmeFilename":"README.md"}