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.