Skip to content

formation-mcp

Repo: idss-mesa/formation-mcp · Language: Go · Registered as: formation

Connects your agent client to the CyVerse Discovery Environment through the Formation API. It lets you launch scientific apps, monitor analyses, and work with Data Store files in natural language.

How MESA runs it

( cd ~/.mesa/repos/formation-mcp && go build -o formation-mcp ./cmd/formation-mcp )
~/.mesa/bin/formation-mcp --transport stdio

It is registered under the name formation with every detected client — see Claude Code, Codex CLI, Antigravity, or OpenCode for the exact registration each one gets.

Go ≥ 1.25 required. Prebuilt binaries for Linux/macOS/Windows are also published on the repo's GitHub Releases (built with GoReleaser) if you'd prefer to download rather than build.

What you can do

  • list / launch apps and wait for completion
  • monitor and stop analyses
  • browse, upload, and set metadata on Data Store files
  • open results in the browser

Authentication

formation-mcp needs CyVerse credentials to launch anything as you. Provide them via env vars (FORMATION_USERNAME / FORMATION_PASSWORD or FORMATION_TOKEN) or a ~/.formation-mcp.yaml file — see Credentials. Configuration precedence is CLI flag > env var > config file.

The server also supports an SSE transport for remote/web clients (Claude.ai) behind nginx + TLS; the repo README has the full deployment guide.