# Stormboard — how to use (mcp.ai)

Connect your Stormboard account and use 41 tools for productivity straight from your AI agent. Connect with your own API key. An online sticky note whiteboard making meetings, brainstorms, and creative projects more productive and effective.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_stormboard?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `stormboard_accept_a_storm_invite`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/stormboard`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/stormboard/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/stormboard/accept/a/storm/invite` — Tool to accept a Storm invitation and join the Storm. Use when a user wants to accept an invitation to join a Storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/add/a/favorite/star` — Tool to add a favorite star to a Storm on the Dashboard. Use when you need to mark a Storm as a favorite.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/check/authentication` — Tool to verify API key authentication validity. Use when you need to test if the API credentials are valid and properly configured.
- `POST https://api.mcp.ai/api/stormboard/close/a/storm` — Tool to close an open Storm, making it read-only. Use when you need to prevent further changes to a Storm. Only the Storm creator or a Storm administrator can close a storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/create/a/line/connector` — Tool to create a line connector between two ideas. Use when you need to establish a connection between a pair of ideas on the Storm board.
  - body: { to_idea_id: integer, from_idea_id: integer }
- `POST https://api.mcp.ai/api/stormboard/create/a/new/chat/messages` — Tool to create a new chat message in a Stormboard storm. Use when you need to post a message to a specific storm's chat.
  - body: { message: string, storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/create/a/new/storm` — Tool to create a new Storm in Stormboard for interactive planning and collaboration. Use when you need to create a digital workspace for brainstorming, planning, or team collaboration.
  - body: { plan: string, title: string, teamId?: string, avatars?: boolean, description?: string, ideacreator?: boolean, votesperuser?: integer }
- `POST https://api.mcp.ai/api/stormboard/create/a/new/tag` — Tool to create a new tag in a Storm without any data related to Ideas. Use when you need to add a new tag to a Storm's tag collection.
  - body: { name: string, storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/create/a/new/user` — Tool to create a new user account in Stormboard. An email will be sent to the newly created user asking them to verify their account. Use when you need to add a new user to the system.
  - body: { email: string, lastname: string, password: string, username: string, firstname: string }
- `POST https://api.mcp.ai/api/stormboard/create/an/idea` — Tool to create a new idea in an existing Stormboard storm. Use when you need to add ideas, notes, or items to a storm with specific content and details.
  - body: { data: string, name: string, type?: string, color?: string, stormid: integer }
- `POST https://api.mcp.ai/api/stormboard/create/tag/data/for/an/idea` — Tool to update tag data for an idea. Any tag not in the change list remains unchanged. Tags not found in the Storm are created automatically with the provided tag data applied.
  - body: { data: object, idea_id: string }
- `POST https://api.mcp.ai/api/stormboard/decline/a/storm/invite` — Tool to decline a Storm invitation and remove it from your list. Use when a user wants to reject an invitation to join a Storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/delete/a/connector/between/ideas` — Tool to delete a line connector between two ideas. Use when you need to remove a connection between a pair of ideas on the Storm board.
  - body: { to_idea_id: integer, from_idea_id: integer }
- `POST https://api.mcp.ai/api/stormboard/delete/a/specific/connector` — Tool to delete a line connector using the connector ID. Use when you need to remove a specific connector from the Storm board.
  - body: { connector_id: string }
- `POST https://api.mcp.ai/api/stormboard/details` — Tool to retrieve detailed information about a specific Storm. Use when you need to get complete Storm details including metadata, settings, and configuration.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/duplicate/a/storm` — Tool to duplicate an existing Storm. Use when you need to create a copy of a Storm with all its content.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/connectors/in/a/storm` — Tool to retrieve a list of connectors within a specific Storm. Use when you need to access relationship data between ideas or elements in a Storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/ideas` — Tool to retrieve all ideas from a Storm. Returns a list of ideas, but Files, Images, and Whiteboards do not contain their corresponding data at this time. Use when you need to get an overview of all i
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/participants` — Tool to retrieve a list of all participants in a Storm. Use when you need to see who has access to a specific Storm and their roles.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/storms/invites` — Tool to retrieve a list of storms that you have been invited to. Use when you need to see pending storm invitations for the authenticated user.
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/tags/in/the/storm` — Tool to retrieve the list of tags that have been created in a Storm. Use when you need to view all tags available in a specific Storm. Note that tag data for individual ideas is not available through 
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/a/list/of/your/storms` — Tool to retrieve a list of storms from Stormboard. Use when you need to browse or access available storms in the user's account.
- `POST https://api.mcp.ai/api/stormboard/get/authentication/info` — Tool to retrieve authentication information and API token for the authenticated user. Use when you need to get authentication details or verify API access credentials.
- `POST https://api.mcp.ai/api/stormboard/get/chat/messages` — Tool to retrieve a list of chat messages from a Stormboard storm. Use when you need to view the chat history for a specific storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/idea/data` — Tool to retrieve detailed data and metadata for a specific idea. Use when you need to fetch information about an idea including its content, position, creator, votes, comments, and associated task det
  - body: { idea_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/info/about/your/user` — Tool to retrieve authenticated user profile information. Use when you need to get the current user's details like name, email, or account metadata.
- `POST https://api.mcp.ai/api/stormboard/get/my/storm/access` — Tool to check if the authenticated user has access to a Storm and retrieve their permission level. Use when verifying user permissions for a specific Storm. Returns 401 error if user lacks access.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/storm/template` — Tool to retrieve template data for a Storm including all sections and subsections. Use when you need to get the organizational structure and template configuration of a Storm.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/tag/data/for/an/idea` — Tool to retrieve tag data for a specific idea in Stormboard. Use when you need to view all tags associated with a particular idea.
  - body: { idea_id: string }
- `POST https://api.mcp.ai/api/stormboard/get/unread/chat/messages` — Tool to retrieve unread chat messages from a specific Storm. Use when you need to check for new messages in a Storm's chat.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/invite/participants` — Tool to invite people to join a Storm by email. Use when you need to add new participants to a Storm.
  - body: { storm_id: string, participants: string[] }
- `POST https://api.mcp.ai/api/stormboard/join/a/storm` — Tool to join a Storm using its ID and access key. Use when a user wants to add themselves to a Storm's participant list.
  - body: { storm_id: string, storm_key: string }
- `POST https://api.mcp.ai/api/stormboard/mark/chat/messages/as/read` — Tool to mark all chat messages as read in a Storm. Use when you need to mark all unread chat messages in a specific Storm as read.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/re/open/a/storm` — Tool to reopen a closed Storm. Use when you need to reopen a previously closed Storm. Note: You must be a Storm administrator or the team owner to perform this action.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/remove/a/favorite/star` — Tool to remove a favorite star from a Storm on the Dashboard. Use when you need to unmark a Storm as a favorite.
  - body: { storm_id: string }
- `POST https://api.mcp.ai/api/stormboard/update/a/line/connector` — Tool to update a specific line connector between two ideas. Use when you need to modify the label or style properties of an existing connector.
  - body: { label?: string, style?: object, connector_id: string }
- `POST https://api.mcp.ai/api/stormboard/update/notifications` — Tool to update user notification preferences. Use when you need to enable or disable email notifications for the authenticated user.
  - body: { email_notifications?: boolean }
- `POST https://api.mcp.ai/api/stormboard/update/section/in/storm` — Tool to update a section's title, description, and/or character in a Storm. Use when you need to modify section properties. Note: You must be a Storm administrator to perform this action.
  - body: { name?: string, storm_id: string, character?: string, description?: string, section_index: string }
- `POST https://api.mcp.ai/api/stormboard/update/storm/legend` — Tool to update the color labels of the legend for a storm. Use when you need to customize the legend labels for storm items. You must be the storm creator or a storm administrator to perform this acti
  - body: { red?: string, blue?: string, green?: string, orange?: string, purple?: string, yellow?: string, storm_id: integer }
- `POST https://api.mcp.ai/api/stormboard/update/your/profile` — Tool to update your user profile information. Use when you need to modify the authenticated user's first name or last name.
  - body: { lastname?: string, firstname?: string }
- `POST https://api.mcp.ai/api/stormboard/verify/your/account` — Tool to verify a Stormboard account using a verification code. Use when you need to confirm account ownership or complete the account verification process.
  - body: { code: string }

## Example prompts
- "What can I do in Stormboard?"
- "Show me a summary of my Stormboard account"

## More
- Page: https://mcp.ai/stormboard
- Agent spec (llms.txt): https://mcp.ai/stormboard/llms.txt
- Postman collection: https://mcp.ai/stormboard/postman.json