Skip to main content
Claude Code can use Shoal in two ways:
  • the Shoal plugin marketplace
  • the hosted Shoal MCP server directly
The marketplace path is the easiest because it bundles both the Shoal skill and the hosted MCP server config.
  1. Open Claude Code.
  2. Add the Shoal marketplace:
/plugin marketplace add shoalresearch/shoal-skill
  1. Install the plugin:
/plugin install shoal@shoalresearch-tools
  1. Reload plugins:
/reload-plugins
  1. When prompted, connect Shoal.
  2. Claude Code opens the browser and redirects you to app.shoal.xyz.
  3. Sign in to Shoal if needed, then approve access.

​
Direct Hosted MCP

If you prefer to configure the remote MCP server yourself, use: 
https://api.shoal.xyz/mcp
See Hosted MCP for the full auth flow.

​
Notes

  • The Shoal plugin uses the hosted MCP server, not a separate local backend.
  • The authenticated Shoal account must already have a valid API key with remaining quota.
  • For terminal-only workflows, see CLI + Skills.