MCP client - Agentic AI Foundation (AAIF) - verified
How to add an MCP server to goose
Where to add MCP servers in goose: extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or goose configure. Its docs list support for stdio and Streamable HTTP and say SSE is not supported. It handles OAuth sign-in for remote servers.
goose homepage - Goose in our tools directory - Compare all MCP clients
- Kind
- Coding agent
- stdio
- Yes
- Streamable HTTP
- Yes
- SSE
- No
Add a server
- Where the config lives
- extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or
goose configure
The example from the goose docs, copied verbatim. Swap in your server's name, command or URL.
extensions:
github:
name: GitHub
cmd: npx
args: [-y @modelcontextprotocol/server-github]
enabled: true
envs: { "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>" }
type: stdio
timeout: 300Which server?
Pick a server from the verified directory of official MCP servers. Each one lists its transport, auth and the setup snippets its vendor publishes, so you can match it to what goose supports.
MCP support
What the goose docs say it supports. Not stated means the docs do not say either way.
| Feature | Value | Source |
|---|---|---|
| ToolsCalls the functions a server exposes. | Yes | goose-docs.ai/docs/tutorials/custom-extensions |
| ResourcesReads data and files a server exposes as resources. | Yes | goose-docs.ai/docs/tutorials/custom-extensions |
| PromptsOffers a server's prompt templates to the user. | Yes | goose-docs.ai/docs/tutorials/custom-extensions |
| SamplingLets a server ask the client's model for a completion. | No | goose-docs.ai/docs/mcp/council-of-mine-mcp |
| RootsTells a server which directories it may work in. | Yes | goose-docs.ai/docs/guides/mcp-roots |
| ElicitationLets a server ask the user for input mid-task. | Yes | goose-docs.ai/docs/guides/mcp-elicitation |
| DiscoveryPicks up tools, prompts or resources a server adds or removes while connected. | Not stated | Docs do not say |
| InstructionsUses the instructions a server sends when it connects. | Not stated | Docs do not say |
| stdioStarts a local server as a subprocess. | Yes | goose-docs.ai/docs/guides/config-files |
| Streamable HTTPConnects to a remote server over the current HTTP transport. | Yes | goose-docs.ai/docs/guides/config-files |
| SSEConnects over the older HTTP+SSE transport. | No | goose-docs.ai/docs/guides/config-files |
| OAuthSigns in to remote servers with OAuth. | Yes | goose-docs.ai/docs/getting-started/using-extensions |
Worth knowing
goose docs state it no longer advertises or handles sampling/createMessage requests after sampling was deprecated in the 2026-07-28 MCP spec, and that SSE extensions are not supported.
Other coding agents
FAQ
Where is the goose MCP config?
extensions key in ~/.config/goose/config.yaml (macOS/Linux) or %APPDATA%\Block\goose\config\config.yaml (Windows); or goose configure. The example on this page is copied from https://goose-docs.ai/docs/getting-started/using-extensions/
Does goose support remote MCP servers over Streamable HTTP?
Yes, per https://goose-docs.ai/docs/guides/config-files/. Its docs list support for stdio and Streamable HTTP and say SSE is not supported.
Does goose support OAuth for MCP servers?
Yes. It handles OAuth sign-in for remote servers. Source: https://goose-docs.ai/docs/getting-started/using-extensions/
Which MCP features does goose support?
Its docs list Tools, Resources, Prompts, Roots and Elicitation. They say Sampling is not supported. They do not state Discovery and Instructions.
Sources
Last verified from the pages below.
- goose docs: Using Extensions - goose-docs.ai
- goose docs: Configuration Files - goose-docs.ai
- goose docs: MCP Roots - goose-docs.ai
- goose docs: MCP Elicitation - goose-docs.ai
- goose docs: Council of Mine Extension (Retired) - goose-docs.ai
- goose docs: Building Custom Extensions - goose-docs.ai
Newsletter
New MCP servers, the week they ship
One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.