ideaboardz-mcp-server

MCP server for integrating with public boards on ideaboardz.com.

Features

• Read board metadata and section IDs
• List stickies from a board
• Create, update, move, delete, and vote stickies

Requirements

• Node.js 18+

Local Setup

npm install
npm run build

Run

npm start

For local development:

npm run dev

Publish to npm

1. Ensure you're logged in:

npm login

2. Build and publish:

npm publish

If the package name is already taken, change name in package.json (for example to a scoped name like @your-scope/ideaboardz-mcp-server) and publish again.

MCP Config (OpenCode)

After publishing, use this OpenCode config:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ideaboardz": {
      "type": "local",
      "command": ["npx", "-y", "ideaboardz-mcp-server"]
    }
  }
}

If you published under a different package name, replace ideaboardz-mcp-server with your published name.

MCP Config (Local Build)

Use this if you want to run from a local clone instead of npm:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ideaboardz": {
      "type": "local",
      "command": ["node", "/absolute/path/to/ideaboardz-mcp/dist/index.js"]
    }
  }
}

Board Input Format

All tools accept a board argument in one of these forms:

• https://ideaboardz.com/for/test/2
• test/2

Tools

• get_board

  • Input: board
  • Output: board id/name and sections (sectionId values are needed for write operations)

• list_stickies

  • Input: board
  • Output: all stickies and grouped by section

• create_sticky

  • Input: board, sectionId, message

• update_sticky

  • Input: board, stickyId, optional sectionId, optional message, optional oldMessage, optional targetSectionId

• delete_sticky

  • Input: board, stickyId, optional sectionId, optional message

• vote_sticky

  • Input: board, stickyId, optional sectionId

Notes

• This server targets publicly accessible board operations.
• Ideaboardz behavior can change over time; if endpoints change, update src/ideaboardz-client.ts.