Skip to main content
Glama
Adios MCP

Adios MCP

Official

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)

https://api.adios.dev/v1/mcp

SSE fallback

https://api.adios.dev/v1/mcp/sse

Public connection metadata

https://api.adios.dev/v1/mcp/config

Public tool discovery

https://api.adios.dev/v1/mcp/tools

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 adios

codex 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 adios

The 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@adios

Restart 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/mcp

Restart 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 adios

Complete 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/mcp

The 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-deploy
Use $skill-installer to install https://github.com/adiosdotdev/mcp/tree/main/plugins/adios-mcp/skills/adios-operate-debug

Skill-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/mcp

Let 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, validate adios.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 configuration

Adios platform documentation: www.adios.dev/mcp

License

MIT

Available Tools

65 tools
adios_capabilitiesA
Read-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_meA
Read-only

Return the current authenticated Adios principal and team context.

Inputs: team_id. Returns: object

build_workspaceC
Destructive

Build an artifact from workspace contents.

Inputs: team_id (required), workspace_id (required). Returns: object

build_workspace_devA
Destructive

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_yamlA
Read-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_requestA
Destructive

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_branchesA
Read-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_fileB
Destructive

Delete one file from a workspace.

Inputs: path (required), team_id (required), workspace_id (required), approved. Returns: object

deploy_workloadA
Destructive

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_workspaceB
Destructive

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_stateA
Read-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_appA
Read-only

Get one team workload, including its source and requested resources.

Inputs: app_id (required), team_id (required). Returns: object

get_observability_incidentA
Read-only

Get one incident and its bounded occurrences by fingerprint.

Inputs: team_id (required), fingerprint (required), limit, since, +2 more. Returns: object

get_pull_requestA
Read-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_usageA
Read-only

Get current disk usage for the run-scoped hosted Git repository.

Inputs: team_id (required), repository_id (required). Returns: object

get_team_deployment_contextA
Read-only

Return the concrete home region used for default deployments by a team.

Inputs: team_id (required). Returns: object

get_workflowA
Read-only

Get one team-scoped workflow definition.

Inputs: team_id (required), workflow_id (required). Returns: object

get_workload_logsB
Read-only

Get recent logs for a workload.

Inputs: team_id (required), workload_id (required), lines. Returns: object

get_workspaceA
Read-only

Get one Adios workspace by ID.

Inputs: team_id (required), workspace_id (required). Returns: object

get_workspace_command_logsB
Read-only

Get logs for a workspace command.

Inputs: team_id (required), command_id (required), workspace_id (required). Returns: object

get_workspace_command_statusB
Read-only

Get the status of a workspace command.

Inputs: team_id (required), command_id (required), workspace_id (required). Returns: object

get_workspace_git_statusB
Read-only

Get workspace git status.

Inputs: team_id (required), workspace_id (required). Returns: object

get_workspace_logsA
Read-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_statusB
Read-only

Get workspace preview runtime status.

Inputs: team_id (required), workspace_id (required). Returns: object

inspect_databaseA
Read-only

Inspect databases and tables for one database workload without executing SQL.

Inputs: team_id (required), workload_id (required), database. Returns: object

lint_workspaceA
Destructive

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_runsA
Read-only

List durable agent run history using bounded team-scoped filters.

Inputs: team_id (required), limit, status, trigger, +5 more. Returns: object

list_agentsA
Read-only

List the agent definitions, versions, suites, and bindings authorized for a team.

Inputs: team_id (required). Returns: object

list_appsB
Read-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_incidentsA
Read-only

Analyze grouped workload incidents and trends for a team.

Inputs: team_id (required), limit, query, since, +2 more. Returns: object

list_project_tasksA
Read-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_requestsA
Read-only

List pull requests for one hosted Git repository.

Inputs: team_id (required), repository_id (required), status. Returns: object

list_repositoriesB
Read-only

List hosted Git repositories visible to the current user in a team.

Inputs: team_id (required). Returns: object

list_repository_branchesA
Read-only

List branches for one hosted Git repository.

Inputs: team_id (required), repository_id (required). Returns: object

list_workflow_runsA
Read-only

List durable runs for one team-scoped workflow.

Inputs: team_id (required), workflow_id (required). Returns: object

list_workflowsA
Read-only

List workflows visible to a team.

Inputs: team_id (required), limit, offset, status. Returns: object

list_workspace_filesA
Read-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_workspacesB
Read-only

List Adios workspaces for a team.

Inputs: team_id (required), limit, offset, status. Returns: object

merge_pull_requestA
Destructive

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_fileA
Destructive

Move or rename a file in a workspace.

Inputs: to (required), from (required), team_id (required), workspace_id (required). Returns: object

prepare_workspace_previewA
Destructive

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_logsB
Read-only

Query bounded team workload logs using the platform observability index.

Inputs: team_id (required), level, limit, query, +5 more. Returns: object

read_workspace_fileA
Read-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_runA
Destructive

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_commandA
Destructive

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_planA
Destructive

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_workspaceA
Read-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_runA
Destructive

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_runA
Destructive

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_stepA
Destructive

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_pushB
Destructive

Push the current workspace branch to its configured Git origin.

Inputs: team_id (required), workspace_id (required), approved. Returns: object

workspace_git_push_branchA
Destructive

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_yamlA
Destructive

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_fileB
Destructive

Write one file to a workspace.

Inputs: path (required), content (required), team_id (required), workspace_id (required), +1 more. Returns: object

write_workspace_filesA
Destructive

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

    B3.1/5.0

    Scored across 65 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      1
      MIT