{
  "markdown": "# vaiz-mcp\n\n[![smithery badge](https://smithery.ai/badge/vaiz/vaiz)](https://smithery.ai/servers/vaiz/vaiz)\n\nMCP (Model Context Protocol) client for Vaiz — connect Cursor/Claude to your Vaiz workspace.\n\n## Installation\n\n```bash\nnpm install -g vaiz-mcp\n```\n\nOr use directly via npx:\n\n```bash\nnpx vaiz-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `VAIZ_API_TOKEN` | Yes | Your Vaiz API key (Bearer token) |\n| `VAIZ_SPACE_ID` | No | Your Vaiz Space ID |\n| `VAIZ_API_URL` | No | MCP API URL (default: `https://api.vaiz.com/mcp`) |\n| `VAIZ_DEBUG` | No | Set to `true` for debug output to stderr |\n\n### Cursor Configuration\n\nCreate or edit `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vaiz\": {\n      \"command\": \"npx\",\n      \"args\": [\"vaiz-mcp@latest\"],\n      \"env\": {\n        \"VAIZ_API_TOKEN\": \"your-api-key\",\n        \"VAIZ_SPACE_ID\": \"your-space-id\"\n      }\n    }\n  }\n}\n```\n\nOr after global installation (`npm install -g vaiz-mcp`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vaiz\": {\n      \"command\": \"vaiz-mcp@latest\",\n      \"env\": {\n        \"VAIZ_API_TOKEN\": \"your-api-key\",\n        \"VAIZ_SPACE_ID\": \"your-space-id\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop Configuration\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vaiz\": {\n      \"command\": \"npx\",\n      \"args\": [\"vaiz-mcp@latest\"],\n      \"env\": {\n        \"VAIZ_API_TOKEN\": \"your-api-key\",\n        \"VAIZ_SPACE_ID\": \"your-space-id\"\n      }\n    }\n  }\n}\n```\n\n## Usage\n\nAfter configuration, Cursor/Claude will automatically connect to your Vaiz workspace and gain access to:\n\n- 🔍 Search tasks, projects, users\n- 📋 Task management (create, edit, comments)\n- 📊 View boards and projects\n- 👥 Team member information\n- 📝 Work with documents and milestones\n\n## Debugging\n\nTo enable debug output, add the `VAIZ_DEBUG` variable:\n\n```json\n{\n  \"mcpServers\": {\n    \"vaiz\": {\n      \"command\": \"npx\",\n      \"args\": [\"vaiz-mcp@latest\"],\n      \"env\": {\n        \"VAIZ_API_TOKEN\": \"your-api-key\",\n        \"VAIZ_DEBUG\": \"true\"\n      }\n    }\n  }\n}\n```\n\nDebug messages will be output to stderr.\n\n## Programmatic Usage\n\nYou can also use the library programmatically:\n\n```typescript\nimport { createVaizMCPClient } from 'vaiz-mcp';\n\nconst client = createVaizMCPClient({\n  apiKey: 'your-api-key',\n  spaceId: 'your-space-id',\n});\n\n// Initialize connection\nconst initResult = await client.initialize();\n\n// Get list of tools\nconst tools = await client.listTools();\n\n// Call a tool\nconst result = await client.callTool('search', { \n  query: 'important task',\n  entityType: 'task' \n});\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/vaiz/vaiz-mcp.git\ncd vaiz-mcp\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run in development mode\nnpm run dev\n```\n\n## Platforms\n\n[![LobeHub](https://lobehub.com/badge/mcp/vaiz-vaiz-mcp)](https://lobehub.com/mcp/vaiz-vaiz-mcp)\n\n## License\n\nMIT\n",
  "bytes": 2981,
  "sha": "a6ef27ddabbb54a708015c9240f85317d1d72f43375403442220e3b1a434c46a",
  "repo_slug": "vaizcom/vaiz-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_vaiz_mcp_2d12bb0b/readme"
}