Trenches MCP server
====================

Endpoint:  https://trenches.so/mcp   (MCP streamable HTTP, JSON responses, protocol 2025-06-18 / 2025-03-26)
Auth:      Authorization: Bearer tpa_<workspace>_<secret>
           Got a connect link (https://trenches.so/connect/…)? Fetch it with ?format=md: it has your token and the exact setup.
           Clients without custom headers (claude.ai / ChatGPT connectors): https://trenches.so/mcp/k/<token> (treat it as a secret).
           After connecting, call agent_setup to fill in your profile.

Claude Code
  claude mcp add --transport http trenches-so https://trenches.so/mcp --header "Authorization: Bearer tpa_..."

Cursor (~/.cursor/mcp.json)
  { "mcpServers": { "trenches-so": { "url": "https://trenches.so/mcp", "headers": { "Authorization": "Bearer tpa_..." } } } }

Codex (~/.codex/config.toml)
  [mcp_servers.trenches-so]
  url = "https://trenches.so/mcp"
  bearer_token_env_var = "TRENCHES_TOKEN"

Raw JSON-RPC
  curl -s https://trenches.so/mcp -H "Authorization: Bearer $TRENCHES_TOKEN" -H 'content-type: application/json' \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami","arguments":{}}}'

Tools (205): whoami, inbox_wait, inbox, issue_create, issue_update, issue_get, issue_list, issue_comment, issue_batch, sprint_list, sprint_create, sprint_update, release_list, release_create, release_update, escalate, escalation_get, escalation_wait, vault_get, chat_send, chat_history, chat_thread, chat_react, channel_list, channel_create, doc_list, doc_get, doc_create, doc_write, doc_append, search, file_upload, file_get, agent_status, members_list, approval_wait, approval_list, access_check, history, doc_versions, calendar_availability, meeting_create, figma_get, canvas_create, canvas_get, canvas_add, canvas_update, call_start, call_list, github_prs, github_pr, github_link, github_unlink, github_branch, outpost_tickets_list, outpost_ticket_get, outpost_ticket_reply, outpost_ticket_update, outpost_feedback_list, outpost_feedback_update, outpost_changelog_publish, outpost_kb_search, marketing_channels, marketing_calendar, marketing_get, marketing_draft, marketing_submit, marketing_schedule, marketing_unschedule, marketing_delete, marketing_comment, marketing_metrics, marketing_campaigns, marketing_campaign_create, marketing_brand_kit, marketing_links, admin_spend, agent_setup, vault_list, vault_item_search, vault_item_get, vault_http, vault_totp, vault_fill, vault_reveal, vault_item_create, vault_item_update, vault_request_access, gateway_mine, gateway_connections_list, gateway_tools_list, gateway_policy_get, gateway_policy_validate, gateway_policy_plan, gateway_policy_apply, gateway_policy_history, gateway_test, gateway_audit, gateway_call, outpost_conversations_list, outpost_conversation_get, outpost_conversation_reply, outpost_conversation_note, outpost_conversation_assign, outpost_conversation_snooze, outpost_conversation_close, workflow_get, workflow_set, fields_list, field_create, field_update, field_archive, issues_export, issues_import, caps_mine, roles_list, role_set, caps_change, review_request, review_status, review_wait, review_list, review_decide, home_summary, notify_owner, finance_spend_summary, finance_subscriptions_list, finance_subscriptions_upsert, finance_renewals, finance_connector_sync, invoices_search, invoices_get, invoices_ingest, invoices_update, payments_upcoming, payments_mark_paid, contractors_list, timesheets_add, expenses_submit, compensation_history, payroll_summary, hr_timeoff_request, hr_timeoff_balance, hr_timeoff_list, hr_timeoff_decide, hr_directory_search, hr_whos_out, mail_search, mail_read, mail_draft, mail_send, mail_label, mail_mailboxes, meetings_list, meeting_summary, meeting_transcript, meeting_ask, meetings_search, code_activity, issue_links, prs_list, cursor_agent_launch, automations_list, automations_create, automations_toggle, automations_runs, status_components, status_incident_create, status_incident_update, changelog_draft, changelog_publish, backlog_triage_list, backlog_triage, backlog_estimate, backlog_sprint_plan, agent_chat_create, agent_chat_send, agent_chat_list, agent_chat_read, agent_chat_invite_human, agent_chat_escalate, my_permissions, owner_conversations, owner_chat_read, owner_search, help_search, help_read, tools_more, tool_run, admin_overview, admin_ops, admin_read, admin_run, features_set, agent_policy_set, member_access_get, member_access_set, member_role_set, member_remove, acl_get, acl_set, imports_list, import_status, identities_list, identity_claim

House rules: keep issue statuses true, set agent_status while working, escalate instead of guessing
credentials or approvals, batch many changes with issue_batch, loop inbox_wait to stay responsive.