Adios MCP
OfficialAdios MCP lets an authenticated MCP client manage Adios team workspaces, workloads, builds, previews, deployments, Git repositories, observability, workflows, and agent-session state.
Inspect capabilities, auth/team context, agents, workflows, repositories, workspaces, workloads/apps, logs, incidents, and database schema.
Create and update workspaces/files, check
adios.yaml, run lint/build/test/start/stop/restart commands, and prepare previews.Build and deploy workloads or workspaces, with approval-gated destructive operations.
Manage hosted Git branches, commits, pushes, pull requests, merges/closes, and repository usage.
Query observability logs and incidents and perform read-only workspace security reviews.
Track agent sessions, plans, events, runs, and proposed/approved project TODOs.
Provides tools for working with hosted Git repositories in Adios workspaces, including branch creation and comparison, repository and branch listing, staging/unstaging, commits, pulls, pushes, Git status checks, and pull request workflows.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Adios MCP list my Adios workspaces"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Adios MCP
Use Adios workspaces, previews, builds, logs, and deployments from Codex, Claude Code, Gemini CLI, Kimi Code, GitHub Copilot, ChatGPT, and other MCP clients.
This repository packages the hosted Adios MCP service for public installation. It includes a portable Agent Plugins v1 package, Codex and Claude Code marketplace plugins, native Gemini CLI and Kimi Code extensions, two reusable workflows, connection examples, and a readable tool reference. The server runs at Adios, so users don't need to deploy anything from this repository.
Endpoints
Purpose | URL |
Streamable HTTP (preferred) |
|
SSE fallback |
|
Public connection metadata |
|
Public tool discovery |
|
Tool calls use Adios OAuth and act as the signed-in user. The connection can reach every team that user belongs to, and each tool call names the team it works on. Connection metadata and tool schemas are public; an Adios account is required to act on workspaces or workloads.
Related MCP server: ServerDock
Install in Codex
Register the GitHub marketplace, install the plugin, and sign in:
codex plugin marketplace add adiosdotdev/mcp
codex plugin add adios-mcp@adios
codex mcp login adioscodex mcp login opens the browser to complete Adios OAuth. The plugin installs the remote MCP connection and both workflow skills. Check the connection with codex mcp list.
To connect only the MCP server without the plugin:
codex mcp add adios --url https://api.adios.dev/v1/mcp
codex mcp login adiosThe equivalent config.toml is in examples/codex-config.toml.
Install in Claude Code
Register the marketplace and install the plugin:
claude plugin marketplace add adiosdotdev/mcp
claude plugin install adios-mcp@adiosRestart Claude Code or run /reload-plugins, then open /mcp and complete OAuth for the Adios server. The plugin installs the MCP connection and both workflow skills.
Install in Gemini CLI
Install the repository as a Gemini CLI extension:
gemini extensions install https://github.com/adiosdotdev/mcpRestart Gemini CLI after installation. The extension loads the hosted MCP server and both workflow skills. If sign-in does not start automatically, run /mcp auth adios in Gemini CLI and complete OAuth in the browser.
Install in Kimi Code
Install the repository from the Kimi Code plugin manager:
/plugins install https://github.com/adiosdotdev/mcp
/reload
/mcp-config login adiosComplete OAuth in the browser after the login command. The plugin connects Kimi Code, including Kimi K3 sessions, to the hosted MCP server and loads both workflow skills.
Install as a portable Agent Plugin
Clients implementing Agent Plugins v1 discover the root plugin.json, mcp.json, and skills/ automatically. For example, install the repository in GitHub Copilot CLI with:
copilot plugins install adiosdotdev/mcpThe portable package starts npx -y @adiosdotdev/mcp, which bridges stdio to the hosted endpoint and completes Adios OAuth when the client connects.
Install only the skills
Ask Codex to install either GitHub path with $skill-installer:
Use $skill-installer to install https://github.com/adiosdotdev/mcp/tree/main/plugins/adios-mcp/skills/adios-build-deployUse $skill-installer to install https://github.com/adiosdotdev/mcp/tree/main/plugins/adios-mcp/skills/adios-operate-debugSkill-only installs do not configure the MCP server; add the adios MCP connection separately.
Use through npm
For MCP clients that start a local stdio command, use the public npm package.
Requires Node.js 20.18.1 or later and npm.
{
"mcpServers": {
"adios": {
"command": "npx",
"args": ["-y", "@adiosdotdev/mcp"]
}
}
}The command starts a local bridge to the hosted Adios endpoint and opens OAuth when the client connects. Nothing from the Adios platform runs locally.
Other MCP clients
Create a remote or Streamable HTTP MCP connection named adios with this URL:
https://api.adios.dev/v1/mcpLet the client complete OAuth rather than adding a static token. If the client does not support Streamable HTTP, use the SSE endpoint shown above. Configuration field names vary by client.
Included workflows
adios-build-deploy: create or import a workspace, update source, validateadios.yaml, run lint/build, start a preview, and deploy after approval.adios-operate-debug: inspect Git/runtime/command state, analyze logs, diagnose failures, and perform verified operational fixes.
See docs/tool-reference.md for the current tool groups and approval-sensitive operations. The live /tools endpoint remains the source of truth.
For the Glama directory listing, see docs/glama.md for build
settings and hosted connector setup.
Safety
Deploys, workload changes, runtime stops, remote Git pushes, pull request merges and closes, and file deletion must remain approval-sensitive. Never commit Adios OAuth tokens, app credentials, or workspace secrets to this repository or to project source.
Repository layout
.agents/plugins/marketplace.json Codex marketplace catalog
.claude-plugin/marketplace.json Claude Code marketplace catalog
plugin.json Portable Agent Plugins v1 manifest
mcp.json Portable npm stdio bridge configuration
kimi.plugin.json Kimi Code plugin manifest
plugins/adios-mcp/.codex-plugin/ Codex plugin manifest
plugins/adios-mcp/.claude-plugin/ Claude Code plugin manifest
plugins/adios-mcp/.mcp.json Hosted MCP connection
plugins/adios-mcp/skills/ Codex and Claude Code workflows
plugins/adios-mcp/assets/ Shared plugin branding
gemini-extension.json Gemini CLI extension manifest
GEMINI.md Gemini CLI extension context
skills/ Portable, Gemini, and Kimi workflow copies
bin/adios-mcp.js npm stdio bridge command
docs/ Tool and operating reference
examples/ Direct client configurationAdios platform documentation: www.adios.dev/mcp
License
MIT
Available Tools
65 toolsadios_capabilitiesARead-only
Describe the Adios agent capabilities and tool groups.
Inputs: no named parameters. Returns: object
append_agent_eventA
Append a compact progress, tool, test, browser, approval, or deployment event to the current agent session.
Inputs: team_id (required), event_type (required), agent_session_id (required), message, +3 more. Returns: object
auth_meARead-only
Return the current authenticated Adios principal and team context.
Inputs: team_id. Returns: object
build_workspaceCDestructive
Build an artifact from workspace contents.
Inputs: team_id (required), workspace_id (required). Returns: object
build_workspace_devADestructive
Queue the canonical workspace build command and return a command_id. Poll get_workspace_command_status and get_workspace_command_logs for progress.
Inputs: team_id (required), workspace_id (required). Returns: object
check_workspace_adios_yamlARead-only
Check adios.yaml for platform security issues, exposed secrets, and risky command patterns before build or deploy.
Inputs: team_id (required), workspace_id (required). Returns: object
close_pull_requestADestructive
Close an open pull request without merging after explicit user approval.
Inputs: team_id (required), repository_id (required), pull_request_id (required), approved. Returns: object
compare_repository_branchesARead-only
Compare two branches in one hosted Git repository without modifying it.
Inputs: base (required), head (required), team_id (required), repository_id (required). Returns: object
create_project_taskA
Save a follow-up TODO as proposed. Creating it never executes it; a user must approve it separately.
Inputs: title (required), team_id (required), agent_session_id (required), company_project_id (required), +3 more. Returns: object
create_pull_requestA
Open a pull request from the agent work-cycle branch. This does not merge it.
Inputs: title (required), team_id (required), repository_id (required), company_project_id (required), +2 more. Returns: object
create_repository_branchA
Create an isolated branch in the run-scoped hosted Git repository.
Inputs: from (required), name (required), team_id (required), repository_id (required). Returns: object
create_repository_workspaceA
Create a workspace from one branch in the run-scoped hosted Git repository.
Inputs: name (required), branch (required), team_id (required), repository_id (required). Returns: object
create_workspaceB
Create a new Adios workspace/project shell.
Inputs: name (required), team_id (required), branch, workload_id, +1 more. Returns: object
delete_workspace_fileBDestructive
Delete one file from a workspace.
Inputs: path (required), team_id (required), workspace_id (required), approved. Returns: object
deploy_workloadADestructive
Deploy a workload using an existing build ID. Omit region to use the team's home region.
Inputs: team_id (required), build_id (required), workload_id (required), region, +1 more. Returns: object
deploy_workspaceBDestructive
Deploy the current workspace or provided build to the linked workload. Omit region to use the team's home region.
Inputs: team_id (required), workspace_id (required), region, approved, +1 more. Returns: object
get_agent_stateARead-only
Get an agent session transcript, runs, current persisted plan, plan steps, and run events.
Inputs: team_id (required), agent_session_id (required). Returns: object
get_appARead-only
Get one team workload, including its source and requested resources.
Inputs: app_id (required), team_id (required). Returns: object
get_observability_incidentARead-only
Get one incident and its bounded occurrences by fingerprint.
Inputs: team_id (required), fingerprint (required), limit, since, +2 more. Returns: object
get_pull_requestARead-only
Get one pull request and its current branch hashes.
Inputs: team_id (required), repository_id (required), pull_request_id (required). Returns: object
get_repository_usageARead-only
Get current disk usage for the run-scoped hosted Git repository.
Inputs: team_id (required), repository_id (required). Returns: object
get_team_deployment_contextARead-only
Return the concrete home region used for default deployments by a team.
Inputs: team_id (required). Returns: object
get_workflowARead-only
Get one team-scoped workflow definition.
Inputs: team_id (required), workflow_id (required). Returns: object
get_workload_logsBRead-only
Get recent logs for a workload.
Inputs: team_id (required), workload_id (required), lines. Returns: object
get_workspaceARead-only
Get one Adios workspace by ID.
Inputs: team_id (required), workspace_id (required). Returns: object
get_workspace_command_logsBRead-only
Get logs for a workspace command.
Inputs: team_id (required), command_id (required), workspace_id (required). Returns: object
get_workspace_command_statusBRead-only
Get the status of a workspace command.
Inputs: team_id (required), command_id (required), workspace_id (required). Returns: object
get_workspace_git_statusBRead-only
Get workspace git status.
Inputs: team_id (required), workspace_id (required). Returns: object
get_workspace_logsARead-only
Get workspace runtime or build logs. Use type=runtime for preview runtime logs, type=build for build logs, and build_id for a specific build.
Inputs: team_id (required), workspace_id (required), type, view, +2 more. Returns: object
get_workspace_run_statusBRead-only
Get workspace preview runtime status.
Inputs: team_id (required), workspace_id (required). Returns: object
inspect_databaseARead-only
Inspect databases and tables for one database workload without executing SQL.
Inputs: team_id (required), workload_id (required), database. Returns: object
lint_workspaceADestructive
Queue the canonical workspace lint command and return a command_id. Poll get_workspace_command_status and get_workspace_command_logs for progress.
Inputs: team_id (required), workspace_id (required). Returns: object
list_agent_runsARead-only
List durable agent run history using bounded team-scoped filters.
Inputs: team_id (required), limit, status, trigger, +5 more. Returns: object
list_agentsARead-only
List the agent definitions, versions, suites, and bindings authorized for a team.
Inputs: team_id (required). Returns: object
list_appsBRead-only
List team workloads, including deployed apps, APIs, workers, databases, and caches.
Inputs: team_id (required), type, limit, offset, +2 more. Returns: object
list_observability_incidentsARead-only
Analyze grouped workload incidents and trends for a team.
Inputs: team_id (required), limit, query, since, +2 more. Returns: object
list_project_tasksARead-only
List durable proposed and approved TODOs for the run-scoped Company Project.
Inputs: team_id (required), company_project_id (required), status. Returns: object
list_pull_requestsARead-only
List pull requests for one hosted Git repository.
Inputs: team_id (required), repository_id (required), status. Returns: object
list_repositoriesBRead-only
List hosted Git repositories visible to the current user in a team.
Inputs: team_id (required). Returns: object
list_repository_branchesARead-only
List branches for one hosted Git repository.
Inputs: team_id (required), repository_id (required). Returns: object
list_workflow_runsARead-only
List durable runs for one team-scoped workflow.
Inputs: team_id (required), workflow_id (required). Returns: object
list_workflowsARead-only
List workflows visible to a team.
Inputs: team_id (required), limit, offset, status. Returns: object
list_workspace_filesARead-only
List the complete visible workspace tree, including project dot-directories such as .adios. Use path '.' to inspect the repository root before answering from connected project context.
Inputs: team_id (required), workspace_id (required), path. Returns: object
list_workspacesBRead-only
List Adios workspaces for a team.
Inputs: team_id (required), limit, offset, status. Returns: object
merge_pull_requestADestructive
Merge an open pull request after explicit user approval.
Inputs: team_id (required), repository_id (required), pull_request_id (required), approved. Returns: object
move_workspace_fileADestructive
Move or rename a file in a workspace.
Inputs: to (required), from (required), team_id (required), workspace_id (required). Returns: object
prepare_workspace_previewADestructive
Create or update a workspace, write files, generate adios.yaml when missing, normalize Node preview build dependencies, run the canonical build/start pipeline, and wait for a preview URL.
Inputs: team_id (required), name, files, branch, +2 more. Returns: object
query_observability_logsBRead-only
Query bounded team workload logs using the platform observability index.
Inputs: team_id (required), level, limit, query, +5 more. Returns: object
read_workspace_fileARead-only
Read one UTF-8 project file after discovering its exact path with list_workspace_files. Sensitive workspace paths remain denied.
Inputs: path (required), team_id (required), workspace_id (required). Returns: object
rename_workspace_previewA
Set or rename a workspace preview's friendly alias without changing its immutable canonical URL. Preview aliases are globally unique and use 3-32 letters, numbers, or interior hyphens.
Inputs: slug (required), team_id (required), workspace_id (required). Returns: object
restart_workspace_runADestructive
Queue workspace preview runtime restart and return a command_id. Builds and readiness can take several minutes; poll get_workspace_command_status and get_workspace_command_logs for progress.
Inputs: team_id (required), workspace_id (required). Returns: object
run_workspace_commandADestructive
Queue a workspace command such as test, lint, build, start, stop, or restart. Returns a command_id; poll status and logs for long-running command progress.
Inputs: kind (required), team_id (required), workspace_id (required). Returns: object
save_agent_planADestructive
Persist the plan for the current coding task before making changes, so the agent can resume later.
Inputs: title (required), team_id (required), agent_session_id (required), steps, +5 more. Returns: object
security_review_workspaceARead-only
Collect the bounded checkpoint diff, manifest inventory, repository context, and Git status for a read-only security review.
Inputs: team_id (required), workspace_id (required). Returns: object
start_workspace_runADestructive
Queue workspace preview runtime start and return a command_id. Builds and readiness can take several minutes; poll get_workspace_command_status and get_workspace_command_logs for progress.
Inputs: team_id (required), workspace_id (required). Returns: object
stop_workspace_runADestructive
Queue workspace preview runtime stop and return a command_id. Poll get_workspace_command_status and get_workspace_command_logs for progress.
Inputs: team_id (required), workspace_id (required), approved. Returns: object
update_agent_plan_stepADestructive
Update one persisted plan step after executing or verifying that step.
Inputs: team_id (required), agent_plan_id (required), agent_session_id (required), agent_plan_step_id (required), +7 more. Returns: object
workspace_git_actionA
Stage or unstage one explicit path on the current isolated agent branch.
Inputs: path (required), action (required), team_id (required), workspace_id (required). Returns: object
workspace_git_commitA
Commit staged approved changes on the current isolated agent branch.
Inputs: message (required), team_id (required), workspace_id (required). Returns: object
workspace_git_pull_branchA
Fast-forward the current isolated Company Project branch from its authoritative Adios Git remote. The pull fails closed when local or remote history diverges.
Inputs: team_id (required), workspace_id (required). Returns: object
workspace_git_pushBDestructive
Push the current workspace branch to its configured Git origin.
Inputs: team_id (required), workspace_id (required), approved. Returns: object
workspace_git_push_branchADestructive
Push the current isolated Company Project work-cycle branch. Merge and close remain separately approval-gated.
Inputs: team_id (required), workspace_id (required). Returns: object
write_workspace_adios_yamlADestructive
Create or replace adios.yaml for a workspace.
Inputs: team_id (required), start_cmd (required), workspace_id (required), runtime, +2 more. Returns: object
write_workspace_fileBDestructive
Write one file to a workspace.
Inputs: path (required), content (required), team_id (required), workspace_id (required), +1 more. Returns: object
write_workspace_filesADestructive
Write multiple files to a workspace in one tool call.
Inputs: files (required), team_id (required), workspace_id (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 65 tools
Several tool pairs have fuzzy boundaries: run_workspace_command explicitly overlaps with build_workspace_dev, lint_workspace, and start/stop/restart_workspace_run, while workspace_git_push and workspace_git_push_branch appear to do nearly the same thing. Objects such as build_workspace vs build_workspace_dev and deploy_workspace vs deploy_workload further complicate selection. Descriptions provide some hints, but an agent would need significant trial and error to pick the right tool.
Most tools follow a readable verb_noun snake_case pattern such as get_*, list_*, and create_*. However, the workspace_git_* group inverts the pattern, and adios_capabilities, auth_me, and security_review_workspace do not fit the dominant convention. The naming is mostly understandable but not consistently predictable.
With 65 tools, this is far beyond the 3-15 sweet spot and even beyond the 25+ threshold. The server appears to be an all-in-one platform, but many variants could be consolidated into fewer composite tools. The sheer number will overwhelm agent tool selection and hurt usability.
The set covers the main workflow end-to-end: workspace and file management, Git operations, pull requests, build/lint/deploy, app and workflow listing, and observability. Minor lifecycle gaps exist, such as no delete_workspace, no update_pull_request, and no workflow run detail/cancel, but they are not likely to block the core agent loop.
Maintenance
Related MCP Connectors
Query, browse, and automate OmegaAI workspaces from any MCP client. Streamable HTTP with OAuth 2.0.
Manage Pipefork API projects, drafts, connections, secrets, and deployments through MCP.
Manage Nife.io cloud apps, sites, secrets and Git integrations from MCP clients.
List, read, edit, and deploy your GenMB AI-generated apps from any MCP client.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables local MCP clients to interact with an AuroraCloud workspace, supporting object listing, content reading, search, and task management through authenticated API calls.44 npmApache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables managed access to workspace file operations, background tasks, Skills, and upstream MCP services through a unified web console with workspace-bound keys and explicit tool permissions.MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to list workspaces, inspect workspace-scoped review findings and hosted run summaries, and prepare, then after explicit user confirmation start or rerun, hosted reviews without exposing raw diffs, artifacts, or credentials.2 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP clients such as editors to start and monitor missions, run the self-healing demo, list departments and blueprints, and approve tasks through the backend API. It also lets trusted departments discover and invoke explicitly granted external stdio or Streamable HTTP tools.1MIT