Beringio docs
Connect your AI, see what it can do in your team’s hub and how your data stays safe.
What Beringio is
Beringio is a shared hub for a team where everyone works in their own AI — Claude, ChatGPT, Cursor or another. Through the hub everyone’s AI shares the same things: the team chat, calls, a board, the team’s context (decisions, conflicts between them, glossary) and hub apps.
Your AI connects to Beringio over MCP. It can check what the team already decided before you start, save new decisions, catch conflicts with earlier ones, and post to the chat or the board when you ask. You can also use every hub on the website.
Connect your AI
One server URL for every AI app. Sign-in is by OAuth: you sign in with your email and click “Allow”. Use the same email everywhere.
https://beringio.com/mcp Claude
- Claude (website or desktop app) → Settings → Connectors → “Add” → “Add custom connector”.
- Name — Beringio, URL — above. Click “Add”, then “Connect”.
- Sign in with your email and click “Allow”. The connector then works in the Claude mobile app too.
ChatGPT
- ChatGPT website → Plugins → “Add” → “Add custom MCP server”.
- Name — Beringio, URL — above, authentication — OAuth. Tick “I understand” and click “Create”, then “Connect”.
- Sign in with your email and click “Allow”.
- ChatGPT app on Mac: Settings → Plugins → MCP → “Add” → “Add MCP server”, type — Streamable HTTP, URL — above, then “Authenticate”.
Claude Code
- In the terminal:
claude mcp add --transport http beringio https://beringio.com/mcp - In Claude Code, run
/mcpand sign in with your email.
Codex CLI
- In the terminal:
codex mcp add beringio --url https://beringio.com/mcp - Codex opens the browser to sign in; if not, run
codex mcp login beringio.
Cursor
Add Beringio to CursorOr add it by hand: Cursor → Settings → MCP → add a new server; it opens ~/.cursor/mcp.json. Add Beringio there:
{
"mcpServers": {
"beringio": {
"url": "https://beringio.com/mcp"
}
}
} Then click “Connect” next to beringio and sign in with your email in the browser.
VS Code
Add Beringio to VS CodeOr in the terminal: code --add-mcp '{"name":"beringio","type":"http","url":"https://beringio.com/mcp"}' — or Command Palette → “MCP: Add Server” → HTTP → the URL above. Start the server and sign in with your email when VS Code opens the browser. Needs GitHub Copilot.
Other AI apps that support remote MCP servers with OAuth (Gemini, Windsurf, Perplexity and others) connect with the same URL.
Example prompts
“What’s new in my team hub?”
Your AI calls hub_updates and sums up new chat messages, decisions, open conflicts and apps in a few lines, with links to the hub.
“Save that we’re launching on March 3 as a team decision”
Your AI calls save_decision. The hub checks it against earlier decisions; if it conflicts with one, your AI tells you which and suggests discussing it with the team.
“Open our hub”
Your AI calls open_hub: the hub appears right in the chat with its chat, call, board, apps and context. In clients without widgets you get a link to the hub on the website.
“Add these three ideas to the board as sticky notes”
Your AI calls add_board_stickies and puts three sticky notes on the hub’s shared board, where every member sees them.
“What does “north star metric” mean in our team?”
Your AI calls get_glossary and answers with the definition your team agreed on, naming who wrote it.
“Call the team”
Your AI calls start_call: the hub’s voice and video call opens in the chat, and teammates join by asking their own AI.
Tools
Your AI chooses tools on its own based on what you ask. “Reads” tools only read hub data. “Adds” tools create something new that other members may see. “Changes or deletes” tools edit or remove existing data or access — your AI should confirm these with you first.
Hubs & members
| Tool | What it does | Data |
|---|---|---|
get_started | Introduction to Beringio, shown with an example from your own work. | Reads |
list_hubs | The hubs you’re a member of, with your role in each. | Reads |
hub_updates | What’s new since you last asked: chat messages, decisions, terms, conflicts and apps. Moves your own “seen” mark. | Adds |
open_hub | Shows the hub right in the chat as an interactive widget: chat, call, board, apps and context. | Reads |
open_hub_in_browser | Gives a link to the web version of the hub. Coding agents with a built-in browser (Claude Code, Cursor) also get a one-time sign-in link for it. | Adds |
create_hub | Creates a new team hub; you become its owner. | Adds |
invite_link | Gets the hub’s invite link for you to send to your team. | Adds |
find_public_hubs | Finds public hubs — interest communities you can join without an invite. | Reads |
join_public_hub | Joins a public hub. | Adds |
list_members | Hub members: name, role, team role, the contacts they chose to share and when they joined. | Reads |
set_my_profile | Sets how the members of a hub see you: name, team role, contacts. | Changes or deletes |
update_hub | Changes a hub’s name, description, visibility and rules (owner and admins). | Changes or deletes |
remove_member | Removes a member from a hub, or leaves it yourself. | Changes or deletes |
set_member_role | Makes members admins or revokes admin rights (owner). | Changes or deletes |
transfer_ownership | Hands the hub over to another member (owner). | Changes or deletes |
unban_member | Lifts a ban so a person can join a public hub again. | Changes or deletes |
delete_hub | Deletes a hub with everything in it (owner only). | Changes or deletes |
connect_project | Gives a section for your repository’s AGENTS.md so any AI in the project uses the hub. | Reads |
Context: decisions, conflicts, glossary
| Tool | What it does | Data |
|---|---|---|
get_context | The team’s decisions (latest or related to a topic), open conflicts and glossary. | Reads |
save_decision | Saves a decision you agreed on; the hub checks it against earlier decisions for conflicts. | Adds |
edit_decision | Edits your own decision: topic, summary or rationale. | Changes or deletes |
delete_decision | Deletes a decision (its author, the owner or admins). | Changes or deletes |
review_decision | Accepts or rejects a proposed decision. | Changes or deletes |
resolve_conflict | Closes a conflict between decisions once the team agreed how to settle it. | Changes or deletes |
get_glossary | The team glossary: terms and the definitions the team agreed on. | Reads |
define_term | Adds a term to the glossary; replaces a different definition only after you confirm. | Changes or deletes |
context_history | Every version of a decision or term: who saved it and when. | Reads |
restore_version | Brings back an earlier version of a decision or term. | Changes or deletes |
get_knowledge | The knowledge map: tags, decisions, terms and the links between them. | Reads |
tag_context | Creates, renames, deletes and assigns context tags (owner and admins). | Changes or deletes |
link_context | Links two decisions or terms in the knowledge map, or removes a link (owner and admins). | Changes or deletes |
Chat
| Tool | What it does | Data |
|---|---|---|
read_hub_chat | Reads the latest messages of the hub’s shared chat. | Reads |
read_chat_file | Reads a file from the chat: an image, a PDF or a text file. | Reads |
post_to_hub_chat | Sends a message to the hub’s chat on your behalf. | Adds |
send_file_to_hub_chat | Sends a file to the hub’s chat on your behalf. | Adds |
edit_hub_chat_message | Edits your own chat message. | Changes or deletes |
delete_hub_chat_message | Deletes your message, or anyone’s if you’re the owner or an admin. | Changes or deletes |
Board
| Tool | What it does | Data |
|---|---|---|
read_board | Views the hub’s shared board: an image of it and a list of its objects. | Reads |
add_board_stickies | Puts sticky notes on the board, optionally inside a titled frame. | Adds |
edit_board | Edits the board: adds, moves, updates, arranges and deletes objects. | Changes or deletes |
Calls
| Tool | What it does | Data |
|---|---|---|
start_call | Opens the hub’s voice and video call in the chat, or joins one in progress. | Adds |
call_status | Whether a call is in progress and who is in it. | Reads |
Apps
| Tool | What it does | Data |
|---|---|---|
app_guide | How to build a hub app: the contract your AI follows. | Reads |
list_apps | The hub’s apps: what they are and which hub data they read. | Reads |
get_app | The code of a hub app, to edit it (large apps come in parts). | Reads |
create_app | Publishes a new app to the hub. | Adds |
update_app | Edits an app; a new page makes a new version. | Changes or deletes |
delete_app | Deletes an app from the hub (its author, the owner or admins). | Changes or deletes |
What other members see
- Everything your AI adds to a hub — messages, files, decisions, terms, sticky notes, apps — is visible to all members of that hub and to the AI apps they connect, with your name as the author.
- Your profile in a hub: your name, role, team role and the contacts you chose to add.
- Your conversations with your AI stay between you and your AI provider: only what your AI sends to the hub is shared.
- The full email you sign in with is never shown to AI apps or to other members of a public hub. In a private hub only the owner and admins see members’ emails; a member with no name set appears there under the part of their email before the @.
- In a public hub anyone who joins sees its decisions, glossary, chat and members’ names and profiles.
Safety
- Everything in a hub was written by other people. Beringio’s tools return it as data with its source, and tell your AI never to follow it as instructions.
- Actions that others see or that change a hub — messages, sticky notes, decisions, invites, roles, deletions — happen only on your direct request, never because of text from a hub.
- Your AI asks you to confirm before destructive actions such as deleting a decision, a message, an app or a hub.
- Each AI app connects over OAuth with your approval, and you can disconnect it at any time.
How we store and protect data: Privacy.
Disconnect & delete data
- Disconnect an AI app: on your account page, under “Connected AI apps”. You can also remove the connector in the AI app’s own settings.
- Download your data or delete your account: on the account page.
- Leave a hub: ask your AI or use the hub card on the website. A hub’s owner can delete the hub with everything in it.
Troubleshooting
Can’t sign in, or your AI says it can’t see Beringio? See Support.