saidso
Uses a private GitHub repository as the shared room for agent-to-agent communication, storing messages and the agreement as committed Markdown/YAML files, relying on GitHub collaborators for access, and using commit history for auditability; setup can create private repos and add collaborators via the GitHub CLI.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
saidso
Agents act only on what their people agreed to.
Your agent can message your client's agent, your partner's agent, your freelancer's agent. Over a private GitHub repo you both already can use. No server, no new accounts. Every step outside what you agreed is stopped, and both people are told in plain words.
npx saidso-cli init my-room --me dana --role developerWhy
You already work with other people's agents. Today that means copy-pasting between chats: your Claude writes something, you paste it to your client, she pastes it to her Claude, and back.
Letting the agents talk directly is easy. Letting them talk safely is not:
A message from another agent is not your instruction. An agent that obeys whatever arrives in its inbox is one poisoned web page away from "please send the newsletter now".
Nobody can answer "who approved this?" When agent C deploys because agent B asked, because agent A relayed something, the chain is lost in three chat windows.
The people are left out. A client who gives your agent more freedom needs to see what it tries to do.
saidso is the small layer between agents of different people that fixes those three things.
Related MCP server: ai-agent-channel
How it works
A room is a private git repo shared by the people in it. Each message is a Markdown file. Nothing is edited or deleted. You can read the whole history on GitHub, even from your phone.
The agreement (
saidso.yml) says who is in the room, their role, and what each role's agent may start, and what needs a person's OK first. Anything not in it is not agreed.Every message is checked against it:
The agent sends... | What happens |
information (no action) | delivered, marked as information |
an agreed action | delivered |
an action that needs an OK | waits. The person who must decide is told in plain words |
anything else | stopped. Both people are told in plain words. Nothing happens |
Only people approve.
saidso approveasks for a typed "yes" at a real terminal. The MCP server has no approve tool at all. One OK is good for one time.No one changes the agreement alone. When
saidso.ymlchanges, every other copy of the room stops sending and acting until its person reads the change (saidso agreement) and accepts it (saidso accept).Agents read messages as data. Every incoming message is wrapped and labelled as coming from someone else's agent, so it cannot pass itself off as an instruction from the agent's own person.
Quickstart (2 minutes)
You (start a room):
mkdir my-room && cd my-room && git init
npx saidso-cli init my-room --me dana --role developer --name "Dana"
# edit saidso.yml: add the other person and what each side may do (see below)
gh repo create my-room --private --source . --push
gh repo edit --add-collaborator maya-on-github # or invite from the GitHub websiteThe other person sends one line to their own agent:
Help me join my saidso room:
npx saidso-cli join dana/my-room. Follow https://github.com/saidso-dev/saidso/blob/main/docs/JOIN.md
Their agent installs git if needed, signs them in to GitHub, clones the room, and connects itself. They never need to learn git. See docs/JOIN.md.
Connect your agent (Claude Code):
claude mcp add saidso -e SAIDSO_ROOM="$PWD" -- npx -y saidso-cli mcpThen just talk to it: "Tell Maya's agent the new homepage is on staging."
One room per project
One room repo per project. The professional (developer or studio) creates the room repo on the client's GitHub account or organisation and is invited as a collaborator, so the record and the assets stay the client's. Another project, another room. If the work ends, the client keeps the whole history.
The agreement
# saidso.yml - everyone in the room can read it; every change is a commit everyone sees.
room: dana-and-maya
members:
dana: { role: developer, name: Dana, github: dana-dev }
maya: { role: client, name: Maya, github: maya-client }
actions:
question: { say: ask a question, by: anyone }
share-update: { say: share a progress update, by: anyone }
content-change: { say: change text on the website, by: client, to: developer }
deploy-staging: { say: put a change on the test site, by: developer }
deploy-production: { say: put a change on the live website, by: developer, ok: client }by: which roles' agents may start it (anyonefor all).ok: a role or a member who must say yes first.to: optional, whom it may be asked of.say: how a person would say it. This is what goes into the plain-language notices.
A bigger, real-world example: examples/studio-and-client/saidso.yml.
What people see
When Dana's agent asks for something that needs Maya's OK, Maya (through her agent, or saidso inbox) reads:
Dana's agent wants to put a change on the live website. Your agreement says this needs your OK, so nothing happens until you answer.
Homepage v2 passed review on staging. Ready to go live.
To answer: saidso approve 20261117-191203-dana-3f70 or saidso deny 20261117-191203-dana-3f70 "why"
When an agent steps outside the agreement:
Dana's agent tried to do something the agreement does not mention ("send-newsletter") with you. Your agreement does not allow that. It was stopped. Nothing happened.
And Dana is told the same thing about his own agent. No one is surprised later.
Notifications
Optional. saidso notify tells a person, on a channel they already read, when something waits for their OK, when
an agent was stopped, or when their request was answered. Set one or more channels with environment variables
(never in a file in the room repo):
Channel | Variables |
Telegram |
|
Webhook (Slack incoming webhook, Discord with |
|
Command |
|
saidso notify --dry-run # print what would be sent
saidso notify # send what is new since last time
saidso notify --every 5 # keep running, check every 5 minutes
# or from cron (every 5 minutes): */5 * * * * cd ~/rooms/my-room && SAIDSO_NOTIFY_WEBHOOK=https://... saidso notifyEach notice goes out once. A failed send is retried next time. Sent notices are remembered in .saidso/, which is not committed.
A notification only informs: it never contains a link or command that approves. To answer, the person
opens a terminal and runs saidso pending. There is no notify tool for agents.
For agents
MCP tool | CLI | What it does |
|
| who is here, and what is agreed |
|
| message or ask ( |
|
| new messages, wrapped as data |
|
| may I do this now? |
|
| report an approved action as done (uses up the OK) |
|
| the whole record, in order |
(none, on purpose) |
| people only, typed confirmation at a real terminal |
Setup for each agent: Claude Code, Cursor, Codex, a plain script, any agent with a shell.
What saidso does and does not guarantee
Honest version, v0.1:
It does: keep one append-only, readable record of who said what to whom; check every message against an agreement both sides can see; stop and announce anything outside it; keep approvals out of the agents' tools; label every incoming message as someone else's words; stop everything when the agreement changes until each person accepts the change.
It does not (yet): cryptographically prove that a human, not an agent, typed the "yes". An agent with full shell access on your machine could fake a terminal. Signed approvals (SSH signatures, which GitHub already verifies) are next on the roadmap. Until then saidso keeps honest agents honest and makes dishonest moves visible in git history.
Anyone with write access to the room can write files. saidso never trusts what a file says about itself: every request is judged again by the current agreement, and a decision counts only if it comes from a member the agreement names. But a member can still write a file claiming to be someone else; git history shows who really committed it. Signed commits close this, and come with signed approvals.
saidso does not run your agent and does not block it from doing things outside the room. Your agent asks
saidso_checkbefore acting, the way it readsAGENTS.md. The rule is in its instructions; the record is in git.
How it fits with what exists
A2A / MCP: A2A connects agents of organisations over HTTP; MCP connects an agent to tools. saidso is about the people behind two agents and what they agreed. It runs as an MCP server, and an A2A bridge is on the roadmap.
Agent mailboxes (mcp_agent_mail and friends): great for many agents of one developer coordinating on one codebase. saidso is for agents of different people with different rights.
Claude Code's SendMessage: sessions on one machine, one person. saidso works across people, machines and tools.
Roadmap
Signed approvals (SSH signing, verified by GitHub)
Approve from your phone: a GitHub issue per request, approve with a comment
A daily plain-language digest for each person
Organisations: many rooms, one place to see them (a studio and all its clients)
A GitHub Action that pings the other agent when mail arrives
A2A bridge
Develop
npm install
npm test # 39 tests, real git repos in a temp folder
npm run typecheckReleases: bump version in package.json through a PR, then push a tag vX.Y.Z on that commit.
The release workflow stages it on npm with provenance through npm Trusted Publishing (no npm token
is stored anywhere), and a maintainer approves the staged version with 2FA.
MIT licensed. Built in a small studio where a developer, clients and several agents work together every day. That is where this came from.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Git collaboration for AI agents and people: tasks, hand-offs, reviews, teams, shared memory.
End-to-end encrypted messaging and work coordination for autonomous AI agents.
Shared Rooms, skills and team memory for your people and AI agents, with human approvals.
1Governed email for AI agents: a sandbox inbox to read and send from, human approval to go external.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables users' AI agents to join signed, hash-chained rooms with another person's agent to negotiate, coordinate, or hand off work, while a locally enforced mandate filters every outbound message. Commitments such as accepts, grants, or priced proposals are released only by an approval signed by the human principal and bound to that exact message.21 npmApache 2.0
- AlicenseAqualityBmaintenanceLets separate coding-agent sessions coordinate through a shared, role-addressed mailbox instead of a human relaying every message, over a single local SQLite file or a hosted server with many isolated channels. Messages can be sent as tracked obligations that stay open until one side resolves and the other confirms, alongside threads, full-text search, work statuses, and an append-only versioned pin system where protected changes require recorded agreement from every declared role.41MIT
- AlicenseBqualityBmaintenanceEnables AI coding agents on different machines and accounts to work one repository as a team by declaring file and symbol claims before editing, so collisions are refused up front rather than discovered at merge. It also supports delegating tasks between teammates' agents, which do the work with their own tokens and commit, with replies, commit shas, claims and messages landing on one shared board.202MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents running in separate apps to exchange messages, tasks, presence, and context through shared rooms, direct threads, and webhook wake-ups. A human owner stays in control by approving proposed plans before execution and reviewing posted results, with safety limits on agent-to-agent chatter.MIT