povio-boards-mcp

MCP server for read-only access to Povio Boards using a personal API key (boards_*).

Cursor setup (published package)

After the package is published to npm:

1. In Povio Boards: Settings → API key → generate a key (shown once).
2. Add to Settings → MCP:

{
  "mcpServers": {
    "povio-boards": {
      "command": "npx",
      "args": ["-y", "povio-boards-mcp"],
      "env": {
        "BOARDS_API_KEY": "boards_your_key_here"
      }
    }
  }
}

The server always targets https://boards.povio.dev. Reload MCP after saving.

Cursor setup (monorepo / unpublished)

cd packages/boards-mcp && npm install && npm run build

{
  "mcpServers": {
    "povio-boards": {
      "command": "node",
      "args": ["/absolute/path/to/boards/packages/boards-mcp/dist/index.js"],
      "env": {
        "BOARDS_API_KEY": "boards_your_key_here"
      }
    }
  }
}

From repo root: npm run boards-mcp:build

Environment

| Variable | Required | Default | |----------|----------|---------| | BOARDS_API_KEY | Yes | — |

The API endpoint is fixed to https://boards.povio.dev in code and is not configurable.

Tools

| Tool | API | |------|-----| | list_boards | GET /api/boards | | search_cards | GET /api/boards/:boardId/cards (paginated search/filters) | | get_board_overview | GET /api/boards/:id/full (projected) | | get_board_full | GET /api/boards/:id/full (raw, size-capped) | | list_board_views | GET /api/boards/:boardId/views | | get_view | GET /api/views/:id | | get_card | GET /api/cards/:id/details |

API keys cannot mutate data; write routes return 401.

Publish to npm

cd packages/boards-mcp
npm run build
npm test
npm login
npm publish

Bump version with npm version patch|minor before each publish. Consumers then use npx -y povio-boards-mcp (no local dist/ path).

Scripts

• npm run build — compile to dist/
• npm start — run stdio MCP server
• npm test — unit tests