# Project Bubble — how to use (mcp.ai)

Connect your Project Bubble account and use 3 tools for project management straight from your AI agent. Connect with your own API key. ProProfs Project is a project management tool that helps teams plan, collaborate, and deliver projects efficiently.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/project_bubble/data/api/get/data/type/fields` — Retrieves the field schema for a specific Bubble data type, returning metadata about each field including its name, data type, and whether it's required. Use this after discovering available data type
  - body: { data_type: string }
- `POST https://api.mcp.ai/api/project_bubble/data/api/get/objects` — Tool to retrieve a list of objects for a specified data type. Use when you need to list items with optional filters, sorting, and pagination.
  - body: { count?: string, limit?: integer, cursor?: string, data_type: string, descending?: string, sort_field?: string, constraints?: string, ignore_fields?: string }
- `POST https://api.mcp.ai/api/project_bubble/data/api/get/record` — Retrieves a single record by its unique ID from a specified data type (table/collection). Use this when you need to fetch detailed information about a specific record and you already know its ID. The 
  - body: { id: string, type: string }

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

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