Auggie CLI MCP server: auggie mcp add --transport http for Sume
Add Sume's hosted MCP to Augment's Auggie CLI with auggie mcp add --transport http and a header, where it is stored, and what a key exposes.

To add Sume to Auggie, Augment's CLI, run auggie mcp add sume --transport http --url https://mcp.sume.com/mcp --header "x-api-key:$SUME_API_KEY". Augment's docs show this shape for remote HTTP servers and say the result is saved to ~/.augment/settings.json (read 2026-10-02).
What the Augment docs show
The Augment page gives one worked example, a Render MCP server added with --transport http, --url and a repeatable --header flag written as KEY:VAL. The docs cover bearer-style headers only; they do not describe an OAuth flow for the CLI, so this post stays with the key route.
| Item | What Augment's docs say | For Sume |
|---|---|---|
| Command | auggie mcp add <name> --transport http --url <url> --header <KEY:VAL> | sume and the hosted URL |
| Headers | Repeatable --header flags; example is an Authorization bearer header | x-api-key:<key> or Authorization:Bearer <key> |
| Storage | Persists to ~/.augment/settings.json | A file holding a key: keep it private |
| OAuth | Not documented on that page | Not claimed here |
auggie mcp add sume --transport http \
--url https://mcp.sume.com/mcp \
--header "x-api-key:$SUME_API_KEY"Where the key ends up
Your shell expands $SUME_API_KEY before Auggie sees it, so the value is written into settings.json as text. Treat that file like any credential file: do not sync it into a dotfiles repo, and rotate the key if it ever lands in a log or chat. Sume's docs say the same for keys that appear in history (OAuth and API keys).
Sume also says an OAuth token is not an API key and that you should not mint keys for OAuth clients as a workaround, so keep the two paths separate.
What an API key lets Auggie do
Sume documents that an API-key session sees the full hosted tool set. That includes paid creates such as generate_image, generate_video and tts_create, each of which needs an idempotency_key. Spend is governed by the wallet and admission checks; dry_run=true previews a call and max_spend_usd caps it when you pass it (MCP tools and gates).
The page I read does not show a per-tool allowlist for Auggie, so put the guard in your instruction: ask Auggie to call tools_schema and dry_run before any paid create, and to report the job id so you can read it with jobs_status instead of submitting again.
First calls to verify
These are the read-only first calls Sume suggests in its MCP quickstart. If the server does not connect, check the header spelling and that the key variable was set when you ran the command.
mcp_healthconfirms the endpoint, auth source and safety posture.tools_listshows every tool visible to this session.account_meconfirms the workspace account context.
Sources
Related posts
More in Integrations
- Make an avatar video from an MCP agent: tools, dry run, spend cap
The hosted MCP server of Sume exposes avatars_list, avatar-videos_create and jobs_wait. How dry_run and max_spend_usd gate a paid call, and the scope you need.
- Poll a Sume job from a CI step with curl and jq: exit codes
A 23-line bash script that polls /v1/jobs/{id}/status and exits 0, 1, 2 or 3, so a CI step can tell done, failed, still running and a bad request apart.
- Bluesky image limits: 4 per post, 2 MB each, alt text required
A Bluesky post embeds up to 4 images of 2,000,000 bytes each, and each needs alt text. Make a JPEG under the cap with Sume Images and write the description.
- Bun.serve webhook receiver for Sume: raw body, verify, dedupe
A 24-line Bun.serve receiver for Sume job webhooks: read the raw body first, verify sume-v1, dedupe on job_id, answer 204 before the work. Tested on Bun 1.4.
Written by Sume