# ProductOS for agents

Connect Claude, Claude Code, Codex, Cursor or any MCP client. Server URL: https://productos.ca/api/mcp/mcp. Sign-in is OAuth; agents act with the role of the person who connected them, every write can be previewed and undone, and deletes go through a separate tool.

## Connect a client

- **Claude**: Settings, Connectors, Add custom connector, paste the URL.
- **Claude Code**: `claude mcp add --transport http --scope user productos https://productos.ca/api/mcp/mcp`
- **Codex**: `codex mcp add productos --url https://productos.ca/api/mcp/mcp && codex mcp login productos`
- **Cursor**: Settings, Tools & MCP, New MCP Server: add the URL, then sign in when Cursor asks.
- **Any MCP client**: Streamable HTTP with OAuth sign-in. No token to copy.

## Tools (52)

### Read the thread

Find anything, walk its links, and load a feature with its evidence, spec and code.

- `whoami`: Who am I
- `get_feature`: Get feature context
- `get_golden_thread`: Get the Golden Thread
- `search_features`: Search features
- `search_entities`: Find entities
- `find_similar`: Check for duplicates
- `search_workspace`: Search the whole workspace
- `list_entities`: List entities
- `count_entities`: Count entities
- `get_entity`: Get an entity
- `get_entities`: Get several entities
- `describe_entity`: Describe an entity type
- `get_workspace_knowledge`: Get workspace knowledge
- `get_workspace`: Get workspace settings
- `get_comments`: Read comments
- `list_notifications`: List my notifications
- `list_saved_views`: List my saved views
- `search_documents`: Search linked documents
- `get_ai_usage`: Get AI usage and cost
- `export_workspace`: Export the workspace to Excel

### Write back

Create, update and link anything, with a dry run first and an inverse to undo it. Deletes live behind their own tool.

- `list_actions`: List write actions
- `execute_action`: Create, update or link
- `execute_destructive_action`: Delete, unlink or merge
- `update_feature_status`: Change a feature's status
- `attach_artifact`: Attach a link to a feature
- `complete_with_workspace_model`: Generate with the workspace model
- `sync_repo_connection`: Re-sync a GitHub connection

### Screenshots and files

Attach a screenshot or file to a Work item, put it in the spec, and look at the images a PM pasted in.

- `upload_attachment`: Upload a file
- `create_attachment_upload`: Start a large file upload
- `finish_attachment_upload`: Finish a file upload
- `list_attachments`: List an entity's files
- `get_attachment`: Read a file

### Meeting transcripts

Bring a Teams, Zoom or Meet transcript in, matched to the team and the customers in the room, read it back as speaker turns, review the feedback processing found in it, and see which asks keep coming up across calls.

- `import_meeting_transcript`: Import a meeting transcript
- `get_meeting_transcript`: Read a meeting transcript
- `process_meeting`: Process a meeting with AI
- `propose_from_meeting`: Propose changes from a meeting
- `list_meeting_proposals`: List a meeting's proposals
- `apply_meeting_proposals`: Accept or reject meeting proposals
- `list_meeting_trends`: List asks heard across meetings

### Run coding sessions

Open a session on a Work item, report progress, ask the PM a question, ask for another repository and open its pull request, and attach the pull request.

- `start_session`: Start a coding session
- `update_session`: Update a session
- `report_progress`: Report session progress
- `log_session_event`: Log a session event
- `ask_user_question`: Ask the PM a question
- `request_repo`: Ask for another repository
- `open_pull_request`: Open a pull request
- `get_session_messages`: Read session messages
- `get_session`: Get a session
- `list_sessions`: List sessions
- `get_session_diff`: Get a session's changed files
- `record_session_outcome`: Record a session's outcome
- `mark_session_complete`: Close a session

MCP reference: https://productos.ca/documentation/api/v1/mcp

## For agents

- MCP server (streamable HTTP, OAuth): https://productos.ca/api/mcp/mcp
- Clients: Claude, Claude Code, Codex, Cursor, Any MCP client
- Index of the site: https://productos.ca/llms.txt
- Documentation: https://productos.ca/documentation