{"_id":"@aditya.mishra/miro-mcp","_rev":"4-a9d6f14a146772c3b598c0ff3ebedfaf","name":"@aditya.mishra/miro-mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@aditya.mishra/miro-mcp","version":"0.1.0","_id":"@aditya.mishra/miro-mcp@0.1.0","maintainers":[{"name":"aditya.mishra","email":"adi.mishra989@gmail.com"}],"homepage":"https://github.com/soul-script/miro-mcp#readme","bugs":{"url":"https://github.com/soul-script/miro-mcp/issues"},"bin":{"miro-mcp":"build/index.js"},"dist":{"shasum":"7a8aaafb0c44397bc9dd077e68c39842e7b2b8e9","tarball":"https://registry.npmjs.org/@aditya.mishra/miro-mcp/-/miro-mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-xCTHqhXKoNNMivfXtcITcMaNVnTjNh8v1MVR6LyzbLm1/ZhTNNGF7g3obzcOM0hknOUEChnU09/hztvrBQuvFw==","signatures":[{"sig":"MEYCIQClD/n5wM9ik1Sk27AQLOX/8xD7QG9zE4QT9Q/gIB9FSgIhAOH6Fn2fHHm4BUe3BLjrl72Pr5mO8C3EiB4Y+khWN9hQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":95648},"type":"module","gitHead":"e6411ece4af31ebaea09e5919191c8fe75253c8e","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"aditya.mishra","actor":{"name":"aditya.mishra","type":"user","email":"adi.mishra989@gmail.com"},"email":"adi.mishra989@gmail.com"},"repository":{"url":"git+https://github.com/soul-script/miro-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server providing full access to the Miro REST API v2 with advanced features including board management, content creation, tags, groups, bulk operations, search, and team collaboration","directories":{},"_nodeVersion":"22.15.1","dependencies":{"yargs":"^17.7.2","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24","@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/miro-mcp_0.1.0_1750183013810_0.4808990908297368","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aditya.mishra/miro-mcp","version":"0.1.1","_id":"@aditya.mishra/miro-mcp@0.1.1","maintainers":[{"name":"aditya.mishra","email":"adi.mishra989@gmail.com"}],"homepage":"https://github.com/soul-script/miro-mcp#readme","bugs":{"url":"https://github.com/soul-script/miro-mcp/issues"},"bin":{"miro-mcp":"build/index.js"},"dist":{"shasum":"9290ca0e3b3f8dfa002e75c91de51ebea021b2d7","tarball":"https://registry.npmjs.org/@aditya.mishra/miro-mcp/-/miro-mcp-0.1.1.tgz","fileCount":5,"integrity":"sha512-lEregZtqIljVzzll8QEMKhGFBglCuMsLygbYYlSfH9PHpa+7VT8R6YJepA35BXuczd/9dxheeHz+W2MiazXXPQ==","signatures":[{"sig":"MEUCIQDHFRhs8RlPpxWdro6Y2+LSFdYWc8/Z0dz8dAL1jkizUgIgRG3AcsmpG/5IYzFYN3WJQDInui9lZzzazsEPJuNz6tc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98264},"type":"module","gitHead":"2b00cadaa9150e744f17bd762bf26e21bab17e87","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"aditya.mishra","actor":{"name":"aditya.mishra","type":"user","email":"adi.mishra989@gmail.com"},"email":"adi.mishra989@gmail.com"},"repository":{"url":"git+https://github.com/soul-script/miro-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server providing full access to the Miro REST API v2 with advanced features including board management, content creation, tags, groups, bulk operations, search, and team collaboration","directories":{},"_nodeVersion":"22.15.1","dependencies":{"yargs":"^17.7.2","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24","@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/miro-mcp_0.1.1_1750183274251_0.18406285666537836","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aditya.mishra/miro-mcp","version":"0.1.2","_id":"@aditya.mishra/miro-mcp@0.1.2","maintainers":[{"name":"aditya.mishra","email":"adi.mishra989@gmail.com"}],"homepage":"https://github.com/soul-script/miro-mcp#readme","bugs":{"url":"https://github.com/soul-script/miro-mcp/issues"},"bin":{"miro-mcp":"build/index.js"},"dist":{"shasum":"8932a1cb34591258fd7b27b5ca7f0ece120f6ba6","tarball":"https://registry.npmjs.org/@aditya.mishra/miro-mcp/-/miro-mcp-0.1.2.tgz","fileCount":5,"integrity":"sha512-VuF0sEdW8+N+tJhBoiw1KpcEmYrBOKDbHbxpF49Pj+wfKquNTdJbyDivUYUK00oq6Vi6ee/m/jwBWDFlw93AHg==","signatures":[{"sig":"MEUCIBeAJRMXA8dLgmdoz1glM2j9VoW2uTExsc+JQxG/FsYwAiEA13vYWULouUm6xckUl2qv4M2XKKeiyW7pOLEkOhIqIuw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99565},"type":"module","gitHead":"d57434617fb5d21cafed1129367d9e4368554789","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","watch":"tsc --watch","prepare":"npm run build","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"_npmUser":{"name":"aditya.mishra","actor":{"name":"aditya.mishra","type":"user","email":"adi.mishra989@gmail.com"},"email":"adi.mishra989@gmail.com"},"repository":{"url":"git+https://github.com/soul-script/miro-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"A comprehensive Model Context Protocol server providing full access to the Miro REST API v2 with advanced features including board management, content creation, tags, groups, bulk operations, search, and team collaboration","directories":{},"_nodeVersion":"22.15.1","dependencies":{"yargs":"^17.7.2","node-fetch":"^3.3.2","@modelcontextprotocol/sdk":"0.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.3","@types/node":"^20.11.24","@types/yargs":"^17.0.33"},"_npmOperationalInternal":{"tmp":"tmp/miro-mcp_0.1.2_1750339397924_0.26821279646420804","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aditya.mishra/miro-mcp","version":"0.1.3","description":"A comprehensive Model Context Protocol server providing full access to the Miro REST API v2 with advanced features including board management, content creation, tags, groups, bulk operations, search, and team collaboration","type":"module","publishConfig":{"access":"public"},"bin":{"miro-mcp":"build/index.js"},"repository":{"type":"git","url":"git+https://github.com/soul-script/miro-mcp.git"},"bugs":{"url":"https://github.com/soul-script/miro-mcp/issues"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","prepare":"npm run build","watch":"tsc --watch","inspector":"npx @modelcontextprotocol/inspector build/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"0.6.0","node-fetch":"^3.3.2","yargs":"^17.7.2"},"devDependencies":{"@types/node":"^20.11.24","@types/yargs":"^17.0.33","typescript":"^5.3.3"},"_id":"@aditya.mishra/miro-mcp@0.1.3","gitHead":"6ef9317fd55a5cf63e6c7340590bfb89eaca0493","homepage":"https://github.com/soul-script/miro-mcp#readme","_nodeVersion":"22.15.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-xX1ajSjxbjoXjBMZh3XwrIkKLw0ExkfiXRauMdnoF+7+8+3dxy/oaE2sYL05RbhhdfCyNeod8Tbmdp985hCCBg==","shasum":"230fdf3f5a5c0f8476a8cc657a8ddd93abc51c0a","tarball":"https://registry.npmjs.org/@aditya.mishra/miro-mcp/-/miro-mcp-0.1.3.tgz","fileCount":5,"unpackedSize":99686,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC3Notk1yVNERtj6V5pXV4YjGfJrdPIMEz9RTiKI+bWWAIhANtoFi7mfgEOZKIwNP17O+E5affwblfMHTOfYUnq6wX7"}]},"_npmUser":{"name":"aditya.mishra","email":"adi.mishra989@gmail.com","actor":{"name":"aditya.mishra","email":"adi.mishra989@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"aditya.mishra","email":"adi.mishra989@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/miro-mcp_0.1.3_1750339629289_0.3852363451861931"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-17T17:56:53.737Z","modified":"2025-06-19T13:27:09.653Z","0.1.0":"2025-06-17T17:56:53.991Z","0.1.1":"2025-06-17T18:01:14.434Z","0.1.2":"2025-06-19T13:23:18.112Z","0.1.3":"2025-06-19T13:27:09.474Z"},"bugs":{"url":"https://github.com/soul-script/miro-mcp/issues"},"homepage":"https://github.com/soul-script/miro-mcp#readme","repository":{"type":"git","url":"git+https://github.com/soul-script/miro-mcp.git"},"description":"A comprehensive Model Context Protocol server providing full access to the Miro REST API v2 with advanced features including board management, content creation, tags, groups, bulk operations, search, and team collaboration","maintainers":[{"name":"aditya.mishra","email":"adi.mishra989@gmail.com"}],"readme":"# Comprehensive Miro MCP Server\n\nA powerful Model Context Protocol server providing complete access to the Miro REST API v2. This enhanced version offers extensive functionality for board management, content creation, collaboration, and advanced features.\n\n## Features\n\n### 🎯 Complete API Coverage\n- **40+ tools** covering all major Miro API endpoints\n- Full CRUD operations for all content types\n- Advanced board management and collaboration features\n- Experimental features like webhooks and advanced search\n\n### 📋 Board Operations\n- `list_boards` - List all boards with search and team filtering\n- `get_board` - Get detailed board information\n- `create_board` - Create new boards with custom settings\n- `update_board` - Modify board properties\n- `copy_board` - Duplicate existing boards\n- `delete_board` - Remove boards permanently\n\n### 🎨 Content Creation\n- **Sticky Notes**: 15+ colors, custom positioning, text content\n- **Text Items**: Rich formatting, custom fonts and sizes\n- **Shapes**: 25+ shapes including flowchart elements\n- **Cards**: Title/description cards for structured content\n- **Images**: Direct URL embedding with size control\n- **Documents**: PDF and document embedding\n- **Embeds**: Video and web content embedding\n- **Frames**: Container elements for organizing content\n- **Connectors**: Link items with optional labels and styling\n\n### 🏷️ Organization Features\n- **Tags**: Create, manage, and attach tags to items\n- **Groups**: Group multiple items for batch operations\n- **Frames**: Organize content in containers\n- **Search**: Find items by content and metadata\n\n### 🚀 Advanced Operations\n- **Bulk Operations**: Create, update, or delete up to 20 items simultaneously (implemented via sequential API calls)\n- **Bulk Connectors**: Create multiple connectors at once to efficiently link items\n- **Board Sharing**: Invite users with granular permissions\n- **Member Management**: Manage board access and roles\n- **Webhooks**: Real-time event notifications (experimental)\n\n### 🎛️ Precise Control\n- **Positioning**: Exact pixel placement with configurable origins\n- **Styling**: Comprehensive visual customization\n- **Geometry**: Control size, rotation, and dimensions\n- **Typography**: Font families, sizes, colors, and alignment\n\n## Installation\n\n```bash\nnpm install @aditya.mishra/miro-mcp\n```\n\n## ⚠️ Important API Limitations & Best Practices\n\nBased on extensive testing with the Miro API v2, please note these critical requirements:\n\n### 🎨 Content Creation Requirements\n- **Text Items**: Only support `width` in geometry, `height` is NOT supported by Miro API\n- **Sticky Notes & Tags**: Must use predefined color names (e.g., \"yellow\", \"red\", \"blue\"), NOT hex codes\n- **Connectors**: Both start and end items MUST exist on the board before creating connectors\n\n### 📊 API Limits\n- **Bulk Operations**: Maximum 20 items per request (create/update/delete)\n- **Board Items**: Minimum limit is 10 when using `get_board_items` with limit parameter\n- **Rate Limiting**: Miro API has rate limits - consider delays for large operations\n\n### 🔍 Working with Items\n- **Item IDs**: Always obtain item IDs from `get_board_items` or item creation responses\n- **Connectors**: Require existing item IDs - use `get_board_items` to find valid item IDs first\n- **Tags**: Use predefined color names from the enum lists in tool descriptions\n\n### 📍 Positioning\n- **Coordinates**: Use `x`, `y` coordinates for precise placement (pixels from board center)\n- **Origins**: Default origin is \"center\" - items are positioned from their center point\n\n## Authentication\n\nObtain a Miro OAuth token from your Miro app and provide it via:\n\n### Environment Variable\n```bash\nexport MIRO_OAUTH_TOKEN=\"your_token_here\"\n```\n\n### Command Line\n```bash\nmiro-mcp --token \"your_token_here\"\n```\n\n## Usage\n\n### As MCP Server\n```json\n{\n  \"mcpServers\": {\n    \"miro-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aditya.mishra/miro-mcp\"],\n      \"env\": {\n        \"MIRO_OAUTH_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Direct Execution\n```bash\n# List available tools\nnpx @modelcontextprotocol/inspector build/index.js\n\n# Run with token\nMIRO_OAUTH_TOKEN=your_token miro-mcp\n```\n\n## Client Configuration\n\nThis MCP server works with any Model Context Protocol compatible client. Here are configuration examples for popular clients:\n\n### Claude Desktop\n\n1. **Locate your configuration file:**\n   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n   - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n   - **Linux**: `~/.config/Claude/claude_desktop_config.json`\n\n2. **Add the Miro MCP server configuration:**\n```json\n{\n  \"mcpServers\": {\n    \"miro-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aditya.mishra/miro-mcp\"],\n      \"env\": {\n        \"MIRO_OAUTH_TOKEN\": \"your_miro_oauth_token_here\"\n      }\n    }\n  }\n}\n```\n\n3. **Restart Claude Desktop** and the Miro tools will be available in your conversations.\n\n### Cursor\n\n1. **Open Cursor Settings** (Cmd/Ctrl + ,)\n2. **Search for \"MCP\"** in settings\n3. **Add MCP Server:**\n   - **Name**: `miro-mcp`\n   - **Command**: `npx`\n   - **Args**: `[\"@aditya.mishra/miro-mcp\"]`\n   - **Environment Variables**: `MIRO_OAUTH_TOKEN=your_token_here`\n\n### Cline (formerly Claude Coder)\n\nAdd to your `.clinerc` or MCP configuration:\n```json\n{\n  \"mcpServers\": {\n    \"miro-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"@aditya.mishra/miro-mcp\"],\n      \"env\": {\n        \"MIRO_OAUTH_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Zed Editor\n\n1. **Open Zed Settings** (Cmd/Ctrl + ,)\n2. **Add to your `settings.json`:**\n```json\n{\n  \"experimental.mcp\": {\n    \"servers\": {\n      \"miro-mcp\": {\n        \"command\": \"npx\",\n        \"args\": [\"@aditya.mishra/miro-mcp\"],\n        \"env\": {\n          \"MIRO_OAUTH_TOKEN\": \"your_token_here\"\n        }\n      }\n    }\n  }\n}\n```\n\n### Continue.dev\n\nAdd to your `continue.json` configuration:\n```json\n{\n  \"mcpServers\": [\n    {\n      \"name\": \"miro-mcp\",\n      \"command\": \"npx\",\n      \"args\": [\"@aditya.mishra/miro-mcp\"],\n      \"env\": {\n        \"MIRO_OAUTH_TOKEN\": \"your_token_here\"\n      }\n    }\n  ]\n}\n```\n\n### Generic MCP Client\n\nFor any other MCP-compatible client, use these parameters:\n- **Command**: `npx`\n- **Arguments**: `[\"@aditya.mishra/miro-mcp\"]`\n- **Environment**: `MIRO_OAUTH_TOKEN=your_token_here`\n- **Working Directory**: Any (the server is self-contained)\n\n## Getting Your Miro OAuth Token\n\n1. **Go to [Miro Developer Portal](https://developers.miro.com/)**\n2. **Create a new app** or use an existing one\n3. **Get your OAuth token** from the app settings\n4. **Set required scopes**: `boards:read`, `boards:write`\n5. **Copy the token** and use it in your MCP client configuration\n\n⚠️ **Security Note**: Keep your OAuth token secure and never commit it to version control.\n\n## Tool Categories\n\n### Board Management (6 tools)\n- Complete board lifecycle management\n- Search and filtering capabilities\n- Team-based organization\n\n### Content Creation (9 tools)\n- All major content types supported\n- Rich styling and positioning options\n- URL-based media embedding\n\n### Item Operations (4 tools)\n- Universal item management\n- Advanced filtering and search\n- Batch processing capabilities\n\n### Bulk Operations (4 tools)\n- Efficient batch create/update/delete via sequential API calls\n- Bulk connector creation for linking multiple items efficiently\n- Up to 20 items per operation (validated and enforced)\n- Optimized for large-scale changes with proper error handling\n\n### Organization (8 tools)\n- Tags for categorization\n- Groups for logical clustering\n- Frames for spatial organization\n- Advanced search capabilities\n\n### Collaboration (2 tools)\n- User invitation and management\n- Role-based permissions\n- Real-time sharing\n\n### Advanced Features (8 tools)\n- Webhook management\n- Frame-based operations\n- Member administration\n- Experimental features\n\n## Examples\n\n### Creating a Project Board\n```javascript\n// 1. Create a new board\nawait createBoard({\n  name: \"Project Planning\",\n  description: \"Q1 project planning board\"\n});\n\n// 2. Create frames for organization\nawait createFrame({\n  boardId: \"board_id\",\n  title: \"Backlog\",\n  x: 0, y: 0, width: 400, height: 600\n});\n\n// 3. Add task cards\nawait createCard({\n  boardId: \"board_id\",\n  title: \"User Authentication\",\n  description: \"Implement OAuth2 login flow\",\n  x: 50, y: 50\n});\n\n// 4. Connect related items\nawait createConnector({\n  boardId: \"board_id\",\n  startItemId: \"item1\",\n  endItemId: \"item2\",\n  caption: \"depends on\"\n});\n\n// 5. Share with team\nawait shareBoardWithUser({\n  boardId: \"board_id\",\n  email: \"team@company.com\",\n  role: \"editor\"\n});\n```\n\n### Creating a Mind Map\n```javascript\n// 1. Central topic\nawait createStickyNote({\n  boardId: \"board_id\",\n  content: \"Main Topic\",\n  color: \"yellow\",\n  x: 0, y: 0\n});\n\n// 2. Branch topics\nconst branches = [\"Idea 1\", \"Idea 2\", \"Idea 3\"];\nfor (let i = 0; i < branches.length; i++) {\n  const item = await createStickyNote({\n    boardId: \"board_id\",\n    content: branches[i],\n    color: \"light_blue\",\n    x: Math.cos(i * 2 * Math.PI / 3) * 200,\n    y: Math.sin(i * 2 * Math.PI / 3) * 200\n  });\n  \n  await createConnector({\n    boardId: \"board_id\",\n    startItemId: \"central_item_id\",\n    endItemId: item.id\n  });\n}\n\n// 3. Add tags for categorization\nawait createTag({\n  boardId: \"board_id\",\n  title: \"Priority High\",\n  fillColor: \"#ff0000\"\n});\n```\n\n### Bulk Content Creation\n```javascript\n// Create multiple items efficiently (up to 20 items)\n// Note: Implemented via sequential API calls for reliability\nawait bulkCreateItems({\n  boardId: \"board_id\",\n  items: [\n    {\n      type: \"sticky_note\",\n      data: { content: \"Task 1\" },\n      style: { fillColor: \"yellow\" },\n      position: { x: 0, y: 0 }\n    },\n    {\n      type: \"sticky_note\", \n      data: { content: \"Task 2\" },\n      style: { fillColor: \"pink\" },\n      position: { x: 100, y: 0 }\n    },\n    {\n      type: \"shape\",\n      data: { shape: \"rectangle\", content: \"Process\" },\n      position: { x: 200, y: 0 },\n      geometry: { width: 150, height: 100 }\n    }\n  ]\n});\n\n// Update multiple items at once\nawait bulkUpdateItems({\n  boardId: \"board_id\",\n  updates: [\n    {\n      id: \"item_id_1\",\n      data: {\n        data: { content: \"Updated Task 1\" },\n        style: { fillColor: \"green\" }\n      }\n    },\n    {\n      id: \"item_id_2\", \n      data: {\n        data: { content: \"Updated Task 2\" },\n        style: { fillColor: \"blue\" }\n      }\n    }\n  ]\n});\n\n// Delete multiple items at once  \nawait bulkDeleteItems({\n  boardId: \"board_id\",\n  itemIds: [\"item_id_1\", \"item_id_2\", \"item_id_3\"]\n});\n```\n\n## Available Shapes\n\n### Basic Shapes\n- rectangle, round_rectangle, circle, triangle\n- rhombus, parallelogram, trapezoid\n- pentagon, hexagon, octagon, star\n- cloud, cross, can\n\n### Arrows\n- right_arrow, left_arrow, left_right_arrow\n\n### Flowchart Elements\n- flow_chart_process, flow_chart_decision\n- flow_chart_document, flow_chart_terminator\n- flow_chart_input_output, flow_chart_delay\n- flow_chart_display, flow_chart_preparation\n\n## Color Palette\n\n### Sticky Note Colors\n- gray, light_yellow, yellow, orange\n- light_green, green, dark_green, cyan\n- light_pink, pink, violet, red\n- light_blue, blue, dark_blue, black\n\n### Custom Colors\nUse any hex color code for shapes, text, and other elements.\n\n## Error Handling\n\nAll operations include comprehensive error handling:\n- Detailed error messages\n- Proper HTTP status codes\n- Graceful fallbacks\n- Clear debugging information\n\n## Rate Limiting\n\nThe server respects Miro's API rate limits:\n- Automatic retry logic\n- Exponential backoff\n- Rate limit headers monitoring\n\n## API Compliance\n\n- Full Miro REST API v2 compatibility\n- Consistent data structures\n- Standard HTTP methods\n- Proper authentication handling\n\n## Development\n\n### Building\n```bash\nnpm run build\n```\n\n### Testing\n```bash\nnpm run inspector\n```\n\n### Watching\n```bash\nnpm run watch\n```\n\n## Limitations\n\n- Maximum 20 items per bulk operation (enforced and validated)\n- Bulk operations use sequential API calls (not true bulk endpoints)\n- DELETE operations may return empty responses (handled automatically)\n- Webhook feature is experimental\n- Some advanced enterprise features require appropriate Miro plan\n- File uploads not supported (URL-based only)\n\n## Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## License\n\nMIT License - see LICENSE file for details\n\n## Support\n\n- GitHub Issues for bug reports\n- Miro API Documentation: https://miroapp.github.io/api-clients/node/\n- MCP Documentation: https://modelcontextprotocol.io/\n\n## Changelog\n\n### v0.2.0 - Comprehensive Enhancement\n- Added 35+ new tools covering complete Miro API\n- Implemented board management operations\n- Added content creation for all item types\n- Introduced tags, groups, and organization features\n- Added bulk operations for efficiency\n- Implemented board sharing and collaboration\n- Added webhooks and experimental features\n- Enhanced error handling and documentation\n\n### v0.1.1 - Initial Release\n- Basic sticky note creation\n- Simple board listing\n- Frame operations\n- Limited shape support\n","readmeFilename":"README.md"}