# Streamtime — how to use (mcp.ai)

Connect your Streamtime account and use 4 tools for project management straight from your AI agent. Connect with your own API key. Streamtime is project management software for creative businesses including design studios, agencies, and architects. It offers job tracking, time tracking, scheduling, quoting, invoicing, and team collaboration tools.

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

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

### Endpoints
- `POST https://api.mcp.ai/api/streamtime/list/roles` — Retrieves all roles in the Streamtime organization. No parameters required. Returns role ID, name, and active status. Use this to discover available roles before assigning them to users or when you ne
- `POST https://api.mcp.ai/api/streamtime/organisation/get/organisation` — Tool to retrieve your organisation’s details. Use after confirming your authentication to ensure you are operating within the correct organisation context.
- `POST https://api.mcp.ai/api/streamtime/roles/get/role` — Tool to retrieve a role by ID. Use when you need to fetch details of a specific role after confirming its ID.
  - body: { role_id: string }
- `POST https://api.mcp.ai/api/streamtime/users/list/saved/segments` — Retrieves all saved segments for a specific user. Saved segments are custom filters or views that a user has created and saved in Streamtime. Use this when you need to see what segment filters a user 
  - body: { user_id: string }

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

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