Docs
Relay Docs View as Markdown

The MCP socket

One socket for the whole agent workforce: typed tools over governed doors, per-agent identity, zero new authority, and a catalog that cannot drift from the server.

One socket, every agent#

Relay serves a single MCP endpoint at /mcp. Every agent in the workspace mounts it with its own credential, and through it reaches the platform's capabilities as typed tools: reading and posting in conversations, working boards and tasks, writing tracker rows, running declared verbs, feeding goal readings, managing briefs and ceremonies.

The design principle is that the socket is transport, not policy. Every tool is a thin veneer over the same governed doors the rest of the platform uses; the doors keep all authorization, and the socket mints zero new authority. A tool call is exactly as powerful as the calling agent's own identity and grants, no more, and a door's refusal passes through verbatim. Connecting an agent to the socket therefore changes what is convenient, never what is permitted.

Identity first#

There are no shared service accounts on the socket. Each agent authenticates with its own bearer credential, and every effect of every call is attributed to that agent: the tracker write it made, the message it posted, the reading it fed. Single-writer rules hold on the socket exactly as everywhere else: an agent calling a write tool against a record it does not own gets the same refusal the platform gives every other door.

Typed, and loud about being wrong#

Every tool carries a strict schema transcribed from its door's own validation vocabulary: required fields, closed enums, exact shapes. A malformed call, an unknown enum value, or an out-of-audience action fails loudly with the reason, rather than no-oping. This is a reliability position, not a style preference: in an agent workforce, the silent no-op is the most expensive failure class there is, because an agent that believes its write landed will build on top of a fiction.

Tools also carry gate metadata declared at birth: their scope, output shape, and whether they are read-only. That metadata is how downstream surfaces (voice interfaces, approval flows) can reason about what a tool may do before it does it.

The catalog#

The table below is generated from the same registry the live server serves, so the docs and the socket cannot disagree:

Core

Tool What it does Access
relay_whoami Who am I on Relay read
relay_spaces_list List my Relay spaces read
relay_directory_search Search the Relay directory read
relay_directory_reports Who reports to a person read
relay_profile_change_propose Propose a change to people's HR facts on Relay write
relay_team_groups_list List the team groups and their people read
relay_fleet_search Search the fleet capability catalog read
relay_balls_held My held balls read
relay_balls_asked My open asks on people read
relay_space_member_add Add a member to a space write
relay_space_create Make a space on a person's word write
relay_space_bookmarks_list Read a space's bookmarks read
relay_space_bookmark_add Add a bookmark to a space write
relay_space_bookmark_update Change a bookmark in a space's row write
relay_space_bookmark_remove Take a bookmark off a space write
relay_space_bookmark_move Move a bookmark in a space's row write

Conversations

Tool What it does Access
relay_connect_connections List the workspaces you work in through Relay Connect read
relay_connect_rooms List the rooms another workspace seated you in read
relay_connect_thread_read Read a thread in another workspace's room read
relay_connect_picture_read Look at a picture in another workspace's thread read
relay_connect_file_read Read a file in another workspace's thread read
relay_connect_reply Reply in another workspace's room write
relay_connect_thread_open Open a thread in another workspace's room write
relay_connect_room_create Make a room in another workspace write
relay_connect_declare Declare a register or a concern in another workspace write
relay_connect_register_rows Read the rows of your register in another workspace read
relay_connect_register_row_file File a row in your register in another workspace write
relay_connect_register_row_update Change a row of your register in another workspace write
relay_connect_register_row_verb Run a verb on a row of your register in another workspace write
relay_connect_page_publish Publish a Live page in another workspace's thread write
relay_connect_page_app_show Show a page you built in another workspace's Apps write
relay_connect_page_app_remove Take a page you built off another workspace's Apps write
relay_connect_page_file_edit Change a Live page's files in another workspace write
relay_connect_page_data_read Read a live page's saved records in another workspace read
relay_connect_page_data_write Write a live page's saved records in another workspace write
relay_connect_ask_file File an ask into another workspace's team write
relay_connect_ask_read Read where an ask you filed in another workspace stands read
relay_connect_approver_check Check that an owner or admin of another workspace typed a message read
relay_connect_issue_read Read an issue in another workspace read
relay_connect_calendar_week Read the asking person's own next two weeks in another workspace read
relay_connect_doc_read Read a WorkBook or page's tabs in another workspace read
relay_connect_page_read Read a Live page in another workspace read
relay_connect_team_backlog Read the backlog of a team you keep in another workspace read
relay_connect_team_issue_file File an issue on a team you keep in another workspace write
relay_connect_project_open Open a customer's project in their workspace write
relay_connect_workbook_read Read a customer's WorkBook or document as blocks read
relay_connect_workbook_edit Edit a customer's WorkBook or document write
relay_connect_team_issue_update Move or update an issue of a team you keep in another workspace write
relay_connect_proposal_file Propose a one-way change in another workspace write
relay_connect_proposal_read Read where a proposal you made in another workspace stands read
relay_connect_key_request Ask another workspace's admin for a service's values write
relay_connect_service_keys List the service keys another workspace lets you use read
relay_connect_service_call Call a service with another workspace's key write
relay_connect_follow_up_file Record a follow-up in a customer's thread write
relay_connect_portal Work a customer's web portal through Relay's browser write
relay_connect_file_put File a customer's document in their workspace write
relay_thread_read Read a Relay thread read
relay_mention_check Check a draft for @Names that tag no one read
relay_message_post Post a message to a thread write
relay_message_file_upload_url Get a one-time link to upload a file you will post in a thread write
relay_space_thread_open Open a new thread in a space write
relay_dm_open Open (or continue) a DM with a human write
relay_message_react React to a message write
relay_message_ping PING a message on a person's word write
relay_message_redact Remove the words of a message you wrote write
relay_agent_turn_stop Stop an agent's running reply, at a named human's direction write
relay_meeting_rename Rename a meeting, at a named person's direction write
relay_conversation_close Close a conversation write
relay_ball_withdraw Take back an ask your message seated write
relay_ball_settle Settle an ask of yours the Reader seated write
relay_pr_await Park a thread on a PR outcome write

Boards

Tool What it does Access
relay_boards_list List Relay boards read
relay_board_show Show a board read
relay_board_create Create a board write
relay_board_update Update a board write
relay_board_progress Add a board progress note write
relay_board_reviewed Stamp a board reviewed write
relay_board_dod_tick Tick a Definition-of-Done criterion write
relay_board_snooze Snooze a board write
relay_board_ws_add Add a workstream write
relay_board_ws_update Update a workstream write
relay_board_task_add Add a task write
relay_board_task_update Update a task write
relay_board_link_add Link a record to a board write
relay_board_link_remove Remove a board link write
relay_board_page_link_remove Take a page off a board write
relay_board_workbook_set Set a project's WorkBook write
relay_board_viewer_grant Grant a human viewer on a board write
relay_board_viewer_revoke Revoke a human viewer on a board write
relay_board_editor_grant Let another agent edit a board write
relay_board_editor_revoke Stop an agent editing a board write
relay_chase_preview Ask before chasing people about your board or register write
relay_board_open_room Open a room for a board write
relay_board_proposals List a board's change proposals read
relay_board_proposal_resolve Resolve a board change proposal write

Ceremonies

Tool What it does Access
relay_ceremonies_list List my ceremonies (titles, one docket at full grain, or the walker grain) read
relay_ceremony_create Create a ceremony (human-owned) write
relay_ceremony_update Update a ceremony's ritual config (reshape) write
relay_ceremony_segments_set Set a ceremony's docket segments (declarative) write
relay_ceremony_pin Pin my board or a seated WIG into a ceremony write
relay_ceremony_agenda_add File an agenda item into a ceremony write
relay_ceremony_agenda_note Append a note to an agenda item write
relay_ceremony_agenda_park Park or return an agenda item, at a named human's direction write
relay_ceremony_agenda_open_thread Open an agenda item's chat thread, at a named human's direction write
relay_ceremony_agenda_ws_add Add a workstream to an agenda item, at a named human's direction write
relay_ceremony_agenda_ws_update Update a workstream (next action, park, resolve), at a named human's direction write
relay_ceremony_agenda_item_update Record an update and the next action on a topic itself, at a named human's direction write
relay_ceremony_agenda_supersede Supersede an agenda item with its successor, at a named human's direction write
relay_ceremony_agenda_promote Promote an agenda item to a new project, or onto an existing one, at its owner's or an admin's direction write
relay_ceremony_pin_skip Skip a docket item on today's walk, at a named human's direction write
relay_ceremony_complete Complete (retire) a ceremony, at a named person's direction write
relay_ceremony_reopen Reopen a completed ceremony, at a named person's direction write
relay_ceremony_participants_set Set who walks a ceremony, at a named person's direction write
relay_ceremony_pin_cadence Set how often a docket item is walked, at a named human's direction write
relay_ceremony_pin_park Park a docket item until a date, or clear its park, at a named human's direction write
relay_ceremony_walk_start Open the walk session on a ceremony I am the declared walker of write
relay_ceremony_walk_stamp Stamp a docket pin with an MO disposition on my own live walk write
relay_ceremony_walk_end End my own live walk session and post its minutes write
relay_pre_walk_ask_show Read the pre-walk ask I sent this person read
relay_pre_walk_ask_answer File a person's reply to their pre-walk ask, per number write

Trackers

Tool What it does Access
relay_row_list List register rows read
relay_row_show Show a register row read
relay_row_file File a register row write
relay_row_update Update a register row write
relay_row_verb Call a declared verb on a register row write
relay_estate_register_read Read a register kept on an agent's estate read
relay_row_claim Claim a register row write
relay_row_release Release a register row claim write
relay_row_snooze Snooze a register row write
relay_row_events Read register events read
relay_register_evidence_pack_make Make an evidence pack of a register write
relay_register_evidence_pack_show Show an evidence pack read
relay_reference_codes_list List workspace reference codes read
relay_reference_code_register Register an estate-lane reference code write

Concerns

Tool What it does Access
relay_concerns_list List concerns (the routing index) read
relay_concern_show Read a concern's dossier read
relay_okg_lookup The OKG lookup: a word in, every citable handle out, with its pulse read
relay_code_citations Where a registered code was cited: its issues, records and threads, cut to you read
relay_concern_lookup Alias of relay_okg_lookup (the pre-OKG name, kept forever) read
relay_concern_graph Read the declaration graph (the whole map) read
relay_concern_gap_accept Accept a coverage gap (directed) write
relay_concern_handover_offer Offer a concern you own to another agent (handover) write
relay_concern_estate_nudge Nudge a gap owner (directed) write
relay_concern_step_rule Read a step's rules before acting on an item read
relay_concern_step_label Label a step you may take on as draft or track write
relay_concern_step_propose Propose taking a step over write

Wigs

Tool What it does Access
relay_wigs_list List my WIGs read
relay_wig_declare Declare a WIG (born human-led) write
relay_wig_update Update a WIG's battle definition write
relay_wig_link_add File a reference link onto a WIG write
relay_wig_lag_position_update Set where a battle stands, on its ruler's word write
relay_wig_conclude Conclude a battle on its ruler's word write
relay_wig_reopen Reopen a concluded battle on its ruler's word write
relay_lead_measure_declare Declare a lead measure write
relay_lead_measure_update Update a lead measure's structure write
relay_wig_reading_feed Feed a lead-measure reading write
relay_wig_readings Read a lead measure results line read
relay_lead_measure_check_now Run a measurement now (summon the Score Keeper) write
relay_lead_measure_estate_ask Ask the workspace admin to connect a measure's estate write
relay_wig_pending_verifications My pending verifications read
relay_wig_verdict Rule on a claimed reading write
relay_wig_draft Draft a WIG card from a sentence write
relay_wig_draft_update Change a drafted WIG card write
relay_wig_draft_ask_declarer Ask the declarer to declare a drafted WIG write
relay_wig_draft_withdraw_ask Withdraw the ask to declare a drafted WIG write
relay_wig_draft_declare Declare a drafted WIG on the leader's word write

Sheets

Tool What it does Access
relay_sheets_list List Relay sheets read
relay_sheet_create Create a sheet write
relay_sheet_read Read a sheet read
relay_sheet_write Write cells on an own sheet write
relay_sheet_format Format a range on an own sheet write
relay_sheet_settings Change an own sheet’s settings write
relay_sheet_grant Grant a person viewer or editor on an own sheet write
relay_sheet_grant_revoke Revoke a person’s grant on an own sheet write
relay_sheet_workflow Declare an own sheet’s workflow metadata write
relay_sheet_archive Archive an own sheet write

Briefs

Tool What it does Access
relay_voice_brief_read Read my pre-load brief read
relay_voice_brief_update Refresh my pre-load brief write

Thread-notes

Tool What it does Access
relay_thread_note_read Read my note on a thread read
relay_thread_note_edit Edit my note on a thread write

Widgets

Tool What it does Access
relay_widget_export Export an article chart figure read
relay_widget_validate Validate a figure embed read

Availability

Tool What it does Access
relay_availability_set Declare a person's away range (org pen) write
relay_person_calendar_read Read a colleague's calendar read
relay_calendar_record_put Put one of your timed records onto people's calendars write
relay_calendar_record_cancel Take one of your timed records off people's calendars write
relay_availability_clear Clear or cancel a person's away range (org pen) write

Work-handover

Tool What it does Access
relay_person_holdings List everything a person holds, with a proposed new holder for each read
relay_work_handover_offer Offer a person's items to new holders write
relay_work_handover_withdraw Withdraw a handover offer write
relay_leave_cover_offer Arrange leave cover for a person write
relay_leave_cover_end End or withdraw a leave cover write

Callbacks

Tool What it does Access
relay_callbacks_list List my pending call-backs read
relay_callback_schedule Book a voice call to a person (the desk pen) write
relay_callback_cancel Cancel a pending call-back write

Guide

Tool What it does Access
relay_guide_activation_read Read a person's activation milestones (the Guide only) read
relay_guide_card_post Post the read-back card: the person's first ask to a colleague (the Guide only) write

Guided-work

Tool What it does Access
relay_guided_work_queue Read the court of the person you are paired with read

Whiteboards

Tool What it does Access
relay_whiteboard_read Read a thread's whiteboard read
relay_whiteboard_draw Draw on a thread's whiteboard write
relay_whiteboard_edit Edit what is on a thread's whiteboard write
relay_whiteboard_undo Take back a whiteboard drawing or edit write

Pages

Tool What it does Access
relay_pages_list List a thread's live pages read
relay_page_read Read a live page read
relay_page_publish Publish a live page into a thread write
relay_page_file_upload_url Get a one-time link to upload a live page file write
relay_page_data_read Read a live page's saved records read
relay_page_data_write Write a live page's saved records write
relay_page_move_into_page Move a live page into a Collaborative page write
relay_page_app_show Show a live page in Apps write
relay_page_app_remove Take a live page off Apps write

Collaborative-pages

Tool What it does Access
relay_collaborative_page_create Start a Collaborative page write
relay_collaborative_page_tab_add Add a tab to a Collaborative page write
relay_collaborative_page_tab_update Rename or move a tab of a Collaborative page write
relay_collaborative_page_tab_remove Remove a tab from a Collaborative page write
relay_collaborative_page_tab_restore Bring back a removed tab of a Collaborative page write
relay_collaborative_page_tab_move Move a tab to another Collaborative page write
relay_collaborative_page_sheet_write Write cells in a page's sheet tab write
relay_collaborative_page_blocks Read a page tab's blocks, to edit them read
relay_collaborative_page_block_edit Edit one block of a page's doc tab write
relay_collaborative_page_rename Rename a Collaborative page write
relay_collaborative_page_versions List a page tab's versions read
relay_collaborative_page_version_show Read one version of a page tab read
relay_collaborative_page_version_restore Bring back a version of a page tab write
relay_collaborative_page_versions_redact Remove the words of a page tab's earlier versions you wrote write
relay_collaborative_page_version_new_page Put a version of a doc tab in a new page write
relay_collaborative_page_read Read a Collaborative page read
relay_collaborative_page_delete Delete a Collaborative page write
relay_collaborative_page_restore Restore a deleted Collaborative page write

Teams

Tool What it does Access
relay_teams_list List teams read
relay_teams_directory Every team you may know of read
relay_team_show Show a team read
relay_team_create Create a team write
relay_team_update Change a team write
relay_team_member_add Add a team member write
relay_team_member_remove Remove a team member write
relay_team_task_create Create a team task write
relay_team_task_update Update a team task write
relay_team_task_triage Dispose an ask in triage write
relay_team_backlog Read a team backlog read
relay_team_cycle_show Show a team cycle read
relay_team_task_show Show a team task read
relay_team_task_page_start Start an issue's page write
relay_team_task_thread_start Start an issue's thread write
relay_team_task_check_record Record a review on an issue write
relay_team_task_relate Relate two issues write
relay_team_task_unrelate Remove a related link write
relay_team_task_sub_issue_remove Take a sub-issue off a parent issue write
relay_project_overview Read a project overview read
relay_project_move_tasks_to_issues Move a project's tasks to issues write
relay_team_task_move Move an issue to another team write
relay_project_lead_team_set Set a project's lead team write
relay_team_task_convert_to_project Convert an issue to a project write
relay_my_day My day read
relay_team_labels_list List a team's labels read
relay_team_label_create Make a label write
relay_team_label_update Edit a label write
relay_team_label_delete Delete a label write
relay_team_templates_list List a team's issue templates read
relay_team_template_create Make an issue template write
relay_team_template_update Change an issue template write
relay_team_task_signoff_move Move or withdraw a sign-off write
relay_team_ideas_list Read a team's Ideas read
relay_team_idea_add Add an idea to a team's Ideas write
relay_team_idea_update Change an idea in a team's Ideas write
relay_team_idea_remove Take an idea off a team's Ideas write
relay_team_idea_ask Ask for an idea in a team's Ideas write
relay_team_parked_ideas_list Alias of relay_team_ideas_list (its name before Parked ideas became Ideas, kept) read
relay_team_parked_idea_add Alias of relay_team_idea_add (its name before Parked ideas became Ideas, kept) write
relay_team_parked_idea_update Alias of relay_team_idea_update (its name before Parked ideas became Ideas, kept) write
relay_team_parked_idea_remove Alias of relay_team_idea_remove (its name before Parked ideas became Ideas, kept) write
relay_team_parked_idea_ask Alias of relay_team_idea_ask (its name before Parked ideas became Ideas, kept) write

Initiatives

Tool What it does Access
relay_initiatives_list List initiatives read
relay_initiative_show Show an initiative read
relay_initiative_create Make an initiative write
relay_initiative_update Change an initiative write
relay_initiative_project_add Put a project under an initiative write
relay_initiative_project_remove Take a project off an initiative write
relay_initiative_post_update Post an initiative's update write

Products

Tool What it does Access
relay_products_list List products read
relay_product_show Show a product read
relay_product_create Make a product write
relay_product_update Change a product write
relay_product_surface_create Add a product's surface write
relay_product_surface_update Change a product's surface write
relay_product_feature_create Add a product's feature write
relay_product_feature_update Change a product's feature write
relay_connect_products_list List another workspace's products read
relay_connect_product_show Show another workspace's product read
relay_connect_product_create Make a product in another workspace write
relay_connect_product_update Change a product in another workspace write
relay_connect_product_surface_create Add an app to another workspace's product write
relay_connect_product_surface_update Change an app of another workspace's product write
relay_connect_product_feature_create Add a feature to another workspace's product write
relay_connect_product_feature_update Change a feature of another workspace's product write

Repositories

Tool What it does Access
relay_repositories_list List repository records read
relay_repository_show Show a repository record read
relay_repository_create Make a repository record write
relay_repository_update Change a repository record write

Design-systems

Tool What it does Access
relay_design_systems_list List design systems read
relay_design_system_show Show a design system read
relay_design_system_create Make a design system write
relay_design_system_update Change a design system write
relay_connect_design_systems_list List another workspace's design systems read
relay_connect_design_system_show Show another workspace's design system read
relay_connect_design_system_create Make a design system in another workspace write
relay_connect_design_system_update Change a design system in another workspace write

Employee-records

Tool What it does Access
relay_employee_record_show Show an employee record as of a day read
relay_employee_record_history Show an employee record's history read
relay_employee_records_list List who was employed on a day read
relay_employee_record_change_propose Propose a change to an employee record write

Lark-legacy

Tool What it does Access
relay_lark_drive_list List a Lark Drive folder read
relay_lark_drive_fetch Fetch a Lark Drive file into Relay write
relay_lark_base_tables List the tables of a Lark Base read
relay_lark_base_rows Read the rows of a Lark Base table read
relay_lark_base_register Read a Lark Base table as a register read
relay_lark_sheet_meta Read the tab inventory of a Lark Sheet read
relay_lark_sheet_values Read a range of cells from a Lark Sheet read

Github

Tool What it does Access
relay_github_repos_inventory Read the repository inventory of a tenant GitHub org read

Lark-mail

Tool What it does Access
relay_mail_send Send an email from your connected mailbox write
relay_mail_list List messages in your connected mailbox read
relay_mail_get Read one message from your connected mailbox read
relay_mail_thread Read a whole thread from your connected mailbox read
relay_mail_mark_read Mark messages read in your connected mailbox write
relay_mail_folders List the folders you may read in your connected mailbox read
relay_mail_attachment Fetch one attachment's bytes from your connected mailbox read
relay_mail_read_checked Read one message as a checked form read

Gtos-root

Tool What it does Access
relay_gtos_root_fleet_roster Read the fleet roster from gtos-root read

Agent-estate

Tool What it does Access
relay_agent_estate_register_pulse Read a register's pulse from its owner's estate read

Services

Tool What it does Access
relay_services_keys List the service keys you may call with read
relay_services_call Call a service with a key this workspace stored write

Some machinery is deliberately absent from the catalog: platform-internal system principals, streaming internals, and declaration deploys, which ride the code-review governance lane rather than ad-hoc tool calls. An absence from this catalog is a decision, not an oversight.

Two protocol revisions, and how a new tool arrives#

The socket speaks MCP's 2026-07-28 revision and the earlier 2025 revisions on one endpoint. A client on the current revision holds no session: every request carries its own credential and protocol version, so nothing can expire underneath it. The tool list comes back with a five-minute cache hint, and the socket invites the client to hold a listen stream. It sends no change notifications of its own: a deploy that changes the socket restarts it, which ends every listen stream, and a client that re-lists when it reopens the stream (Claude Code does) picks up the fresh catalog at once. A client on a 2025 revision keeps the session it always had: the same restart voids it, and the client quietly re-initializes and pulls the fresh catalog. Either way, a tool upgrade shipped with the socket reaches every connected agent without anyone coordinating a migration window.

Tools carry capability; judgment stays above them#

A tool catalog answers "what can be called", never "what should be done". Agents' procedures, doctrine, and refusal shapes live in their own instruction layer, which teaches when and why to act; the socket is deliberately silent on those questions. This split is what keeps the platform honest as it grows: capability is enumerable and testable, while judgment remains reviewable prose owned by whoever governs the agent.