# Loomio — how to use (mcp.ai)

Connect your Loomio account and use 4 tools for project management straight from your AI agent. Connect with your own API key. Loomio is a collaborative decision-making platform that enables groups to discuss, propose, and make decisions together.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_loomio?ms=1787291280000`
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. `loomio_list_groups`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/loomio`
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/loomio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/loomio/list/groups` — Tool to list all groups accessible to the user. Use when you need to retrieve and paginate user groups.
  - body: { page?: integer, filter?: string, includes?: string[], per_page?: integer }
- `POST https://api.mcp.ai/api/loomio/list/polls` — Tool to list all polls accessible to the user. Use when you need to retrieve poll IDs and basic metadata.
  - body: { status?: string, group_id?: integer, per_page?: integer, discussion_id?: integer }
- `POST https://api.mcp.ai/api/loomio/show/group` — Tool to retrieve details of a specific group. Use when you have a group_id and need its full metadata.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/loomio/show/poll` — Tool to retrieve details of a specific poll. Use when you have a poll ID and need its full metadata.
  - body: { poll_id: string }

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

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