Skip to main content
Beringin AI
Model Context Protocol
SEC.00

Connect Beringin AI to Your Coding Tools

Manage projects, create tasks, and search across your Beringin workspace from Claude Code, Cursor, VS Code, and other AI tools.

13+

AI coding tools supported

5

min setup

103

MCP tools available

SEC.01

What is Model Context Protocol?

MCP Protocol

MCP is like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect devices, MCP provides a standardized way to connect AI tools to external systems like Beringin AI.

You

Natural language prompt

AI Coding Tool

Claude Code · Cursor · VS Code · Windsurf · +8 more

MCP Client
JSON-RPC 2.0 · HTTPS · OAuth

Beringin MCP Server

8

Global

26

Project

26

Write

40

Workspace

Beringin DB

Your projects, tasks, and data

Remote (HTTP/SSE)

Tools

Tools

Executable functions that AI can invoke to perform actions — like creating tasks, querying projects, or searching across your workspace.

Resources

Data sources that provide contextual information to AI — like project details, task lists, and team member information.

Prompts

Reusable templates that help structure AI interactions — like system prompts and few-shot examples.

Beringin AI exposes Tools today. Resources and Prompts are part of the protocol but are not served by this endpoint.

How It Connects

Remote

Remote (HTTP/SSE)

Uses HTTP with optional streaming for remote server communication. Best for teams and multi-device workflows.

Access from any computer
Secure OAuth2 authentication
Share across team members
SEC.02

Supported Coding Tools

Beringin AI's MCP server works with any spec-compliant client. Here are the most popular ones:

Claude Code
Config:
.mcp.json
Root key:
mcpServers
Transports:
stdio, HTTP
Claude Desktop & Web
Runs from Anthropic's cloud
Config:
Connectors UI
Root key:
—
Transports:
HTTP
Cursor
Config:
.cursor/mcp.json
Root key:
mcpServers
Transports:
stdio, HTTP
OpenCode
Different root key
Config:
opencode.json
Root key:
mcp
Transports:
stdio, HTTP
VS Code + Copilot
Different root key
Config:
.vscode/mcp.json
Root key:
servers
Transports:
stdio, HTTP
Devin Desktop / Windsurf
Legacy Cascade only
Config:
.devin/mcp_config.json
Root key:
mcpServers
Transports:
stdio, HTTP
Cline
Config:
cline_mcp_settings.json
Root key:
mcpServers
Transports:
stdio, HTTP
Continue.dev
YAML format
Config:
.continue/mcpServers/*.yaml
Root key:
mcpServers
Transports:
stdio, HTTP
Zed
Different root key
Config:
settings.json
Root key:
context_servers
Transports:
stdio, HTTP
JetBrains IDEs
Config:
Settings UI
Root key:
GUI
Transports:
stdio, HTTP
Codex CLI
TOML format
Config:
~/.codex/config.toml
Root key:
mcp_servers
Transports:
stdio, HTTP
Amazon Q Developer
Not re-verified
Config:
.amazonq/default.json
Root key:
mcpServers
Transports:
stdio, HTTP
Antigravity / Gemini CLI
Replaced by Antigravity
Config:
Native
Root key:
—
Transports:
stdio, HTTP
SEC.03

Beringin AI MCP Tools

103 tools

103 tools available via MCP, organized by scope. All tools respect your existing project permissions.

The subscribe_to_task_events tools open a push channel: while your session is open, Beringin streams task changes (including edits made by other agents or the background worker) to your AI tool.

Cross-Project Tools· 8 tools
get_started

Start here: your context, what this connection can do, and what is missing

"What can you do?"

get_user_profile

Get your profile information (name, email, tier, organizations)

"What's my profile?"

switch_current_organization

Switch which organization your requests act in

"Switch to my Beringin workspace"

list_my_projects

List all projects you have access to

"List my projects"

get_project_summary

Get a summary of a specific project

"Show summary of Website Redesign"

find_tasks_across_projects

Search tasks across all projects

"Find tasks about login"

get_overdue_tasks

Find overdue tasks across projects

"What tasks are overdue?"

compare_projects

Compare metrics between projects

"Compare Project A and B"

Project Read Tools· 26 tools
list_project_tasks

List tasks in a specific project

"Show tasks in Mobile App"

get_task_details

Get detailed task information

"Get details of task Fix login"

list_milestones

List a project's milestones with progress

"List milestones in Mobile App"

get_milestone_details

Get a milestone and the tasks inside it

"Show details for milestone v1.0"

list_card_tables

List Kanban boards

"List Kanban boards"

get_card_table_details

Get board details with cards

"Show Sprint 1 board"

list_schedule_events

List upcoming calendar events

"What's on the schedule?"

list_team_chats

List team chat channels

"List team chat channels"

get_team_chat_messages

Get chat messages

"Show recent chat messages"

find_project_items

Search within a project

"Search for auth in project"

summarize_project_updates

Summarize recent activity

"Summarize recent activity"

list_project_members

List team members

"Who's in this project?"

list_project_documents

List documents in a project

"List documents in Mobile App"

read_project_document

Read a project document's content

"Read the PRD document"

query_project_documents

Semantic search across project documents

"Find docs about pricing"

list_project_folders

List folders in a project

"List folders in Mobile App"

list_checklist_items

List a task's checklist items

"Show checklist for task Fix bug"

list_task_dependencies

List a task's blockedBy / blocks dependencies

"What does task Fix bug block?"

get_project_dependency_graph

Full task dependency map for a project

"Show the dependency map"

list_task_comments

List comments on a task

"Show comments on task Fix bug"

list_active_subscriptions

List your active task event subscriptions

"Show my active subscriptions"

subscribe_to_task_events

Watch a project for task changes (push events)

"Watch this project for task changes"

unsubscribe_from_task_events

Remove a task event subscription

"Stop watching task events"

get_board_health

Analyse a board: bottlenecks, stale and overdue cards, workload

"How is the Sprint 1 board doing?"

list_project_artifacts

List artifacts published into a project

"List artifacts in Mobile App"

read_project_artifact

Read one artifact, including its content

"Read the Q4 dashboard artifact"

Project Write Tools· 26 tools
create_project_task

Create a new task (name-based assignment)

"Create task Fix bug assigned to Budi"

update_project_task

Update an existing task

"Update task Fix bug to In Progress"

archive_project_task

Archive a task (and its subtasks), or restore it

"Archive task Fix bug"

archive_project_tasks

Archive or restore many tasks at once by status, priority, milestone or age (dry run by default)

"Archive every Done task older than 30 days"

create_milestone

Create a milestone in a project

"Create milestone v1.2 due next month"

update_milestone

Edit a milestone's name, dates, or description

"Rename milestone v1.2 to Launch"

update_milestone_status

Set a milestone's status (pending, in progress, completed)

"Mark milestone v1.2 as completed"

move_card

Move a card between Kanban columns

"Move task Fix bug to Done"

add_card_to_table

Add a new card to a Kanban column

"Add card to Sprint 1 board"

create_project_document

Create a new project document (authored, file reference, or link)

"Create a doc called PRD in Mobile App"

create_project_artifact

Create a project artifact (authored, file, link, or web component)

"Publish a web component report to the project"

patch_project_artifact

Partially edit an artifact; each patch saves a new version

"Update the artifact's summary section"

update_project_document

Update a project document (rename, content, folder, visibility)

"Rename doc PRD and move it to Design folder"

patch_project_document

Partially edit a document's markdown without resending it all

"Replace the pricing section in the PRD"

create_project_folder

Create a new folder in a project

"Create folder Design"

update_project_folder

Rename, recolor, or move a folder

"Rename folder Design to UX"

add_checklist_item

Add a checklist item to a task

"Add a checklist item to task Fix bug"

update_checklist_item

Edit or toggle a checklist item

"Mark checklist item done"

remove_checklist_item

Delete a checklist item from a task

"Remove checklist item from task"

reorder_checklist_items

Reorder a task's checklist items

"Reorder the checklist"

add_task_dependency

Add a task dependency (with cycle detection)

"Make task Fix bug depend on Review"

remove_task_dependency

Remove a task dependency

"Remove the dependency"

add_task_comment

Add a comment to a task

"Add a comment to task Fix bug"

update_task_comment

Edit a comment (author only)

"Edit my comment"

delete_task_comment

Delete a comment (author only)

"Delete my comment"

send_channel_message

Post a message into a team chat channel as you

"Post the status update to #general"

Project Admin Tools· 3 tools
delete_project_task

Delete a task (admin role or higher)

"Delete task Fix bug"

delete_project_document

Delete a project document (admin role or higher)

"Delete the PRD document"

delete_project_folder

Delete a folder (admin role or higher)

"Delete folder Design"

Personal Tools· 21 tools
list_notes

List your personal notes

"List my notes"

get_note

Read one note, including its content

"Read my note about pricing"

list_note_folders

List your note folders

"Show my note folders"

create_note

Create a personal note

"Save this summary to a new note"

update_note

Edit, pin, file, archive, or restore a note

"Add the tag research to that note"

delete_note

Move a note to trash, or delete it permanently

"Move that note to trash"

get_active_timer

Check the timer that is currently running

"Is my timer running?"

list_time_entries

List logged time entries with an optional date range

"What did I log this week?"

get_time_summary

Total hours, billable split, and per-project breakdown

"How many hours did I track this month?"

start_timer

Start tracking time on a task

"Start a timer on Fix login"

stop_timer

Stop the running timer and save the entry

"Stop the timer"

create_time_entry

Log time manually against a task

"Log 90 minutes on Review PR"

get_task_time_stats

Total time logged against one task

"How long did Fix login take?"

get_project_time_stats

Total tracked time for a project, by member

"How much effort went into Mobile App?"

get_focus_session

Check the focus (Pomodoro) session that is running

"How much time is left on my focus session?"

get_focus_stats

Per-task focus time, sessions, and completion

"Where did my focus time go?"

start_focus_session

Start a focus or break session

"Start a 25 minute focus block on the report"

complete_focus_session

Finish or cancel the running focus session

"Finish this focus session"

mark_focus_task

Mark a focus task done or not done

"Mark the report task as done"

list_notifications

List notifications with the unread count

"What did I miss?"

mark_notifications_read

Mark notifications as read

"Mark all notifications read"

Background Agent Tools· 10 tools
list_threads

List your background agent threads

"List my background threads"

get_thread

Read a thread with its recent turns and results

"What did thread T-4KD2 produce?"

wait_thread

Wait for a thread to settle, with a bounded timeout

"Wait for that thread to finish"

start_thread

Start a background agent thread (spends credits)

"Research our competitors in the background"

continue_thread

Send a follow-up to a settled thread

"Ask that thread to add a summary section"

steer_thread

Correct a thread that is still working

"Tell the running thread to use 2025 data"

answer_thread

Approve, reject, or answer a thread waiting on you

"Approve the plan that thread is waiting on"

rename_thread

Rename a thread

"Rename that thread to Q4 research"

archive_thread

Archive or unarchive a thread

"Archive that thread"

save_thread_document

Save a thread's answer as a project document

"Save that thread's answer as a project document"

Workspace Tools· 7 tools
get_wiki

Get the current organization's wiki

"Show this organization's wiki"

list_wiki_pages

List wiki pages you may read

"List wiki pages about onboarding"

read_wiki_page

Read a wiki page, including its content

"Read the deployment runbook"

create_wiki_page

Create a wiki page (published only if allowed)

"Write a wiki page from this research"

update_wiki_page

Edit a wiki page's content or visibility

"Add a rollback section to that page"

list_organizations

List the workspaces you belong to

"Which workspaces am I in?"

list_organization_members

List the members of an organization

"Who is in this organization?"

Billing Tools· 2 tools
get_credit_balance

Read your credit balance and any held credits

"How many credits do I have left?"

get_credit_usage

See where your credits went and the trend

"What used my credits this week?"

SEC.04

Setup Guides

Beringin AI connects to your coding tool via Remote (HTTP). Follow these steps — most setups take less than 5 minutes.

Add Beringin to Your AI Tool

Copy the config snippet for your tool below. Beringin uses OAuth — no API token needed.

  • → File: .mcp.json at the project root (shared with the team) or ~/.claude.json (user-wide)
  • → A remote entry needs "type": "http" — a url without a type is rejected
  • → CLI: claude mcp add --transport http beringin https://apps.beringinhub.com/api/mcp
JSON
{
  "mcpServers": {
    "beringin": {
      "type": "http",
      "url": "https://apps.beringinhub.com/api/mcp"
    }
  }
}

Remote connection — works from any computer

Authorize via OAuth

Beringin uses OAuth 2.1 with PKCE and dynamic client registration, so most tools open a browser and ask you to approve access — there is no token to paste. The consent screen also lets you pick how long the connection lasts (1 day up to no expiry); choose a longer window for tools that never refresh tokens.

Test It

"List my projects"
"Show tasks in [project]"
"Create task Fix bug"
"What tasks are overdue?"
SEC.05

Example Use Cases

Here's what you can ask your AI tool once connected:

"List my projects"

Shows all your Beringin projects with status and stats

"Show tasks in Website Redesign"

Lists all tasks in the specified project

"Create task Fix login bug assigned to Budi"

Creates a new task with name-based assignment

"What tasks are overdue?"

Checks overdue tasks across all your projects

"Compare Website Redesign and Mobile App"

Side-by-side comparison of project metrics

"Search for authentication tasks"

Full-text search across all projects

"Summarize recent activity in Mobile App"

AI-generated summary of recent changes

"Update task Fix login to In Progress"

Changes task status

"Show milestones in Mobile App"

Lists milestones with progress and task counts

"Archive task Fix login bug"

Archives the task and its subtasks

SEC.06

Security & Permissions

Here's how we keep your Beringin workspace safe:

Secure OAuth

Connections use OAuth 2.1 with PKCE — no long-lived tokens to leak. You authorize each tool through Beringin's login screen and can cap how long the grant lasts.

Revoke Anytime

Disconnect any tool instantly from Settings › AI Tools (Connected Apps). Its tokens stop working immediately.

Audit Trail

Every tool call is logged with its name, transport, outcome and duration. Review who did what and when.

Scoped Access

Tools only see projects you have access to. No admin access = no admin tools.

HTTPS Encryption

Remote connections use HTTPS with TLS encryption end to end.

Token Scopes

Each token carries only the scopes you approved. Project access (projects:read / projects:write) is separate from notes, time tracking, notifications, threads, wiki, billing and organization scopes, so a tool can be given reading access without ever writing. Read-only tools reject a write-only grant.

Permission Matrix

Project-scoped tools are gated by your project role. Personal, agent and workspace tools are gated by OAuth scope instead.

Viewer

ReadWriteAdmin

Editor

ReadWriteAdmin

Admin

ReadWriteAdmin

Owner

ReadWriteAdmin
SEC.07

Troubleshooting

Common issues and how to fix them:

  • Make sure you completed the Beringin login and clicked Authorize
  • Check that pop-ups are allowed for your AI tool
  • Re-trigger the OAuth flow by restarting your AI tool (OpenCode: opencode mcp auth beringin)

Get Started

Connect your AI tool in under 5 minutes via secure OAuth.

Open AI Tools settings