Skip to main content
Use this page if you want Shoal tools inside claude.ai.

​
What This Path Uses

  • Hosted Shoal MCP server: https://api.shoal.xyz/mcp
  • Shoal app OAuth through app.shoal.xyz
  • Tool access based on the authenticated Shoal account’s plan

​
Before You Start

  • You need a Shoal account
  • That account must already have a valid API key with remaining quota

​
Setup

  1. Open Claude Web.
  2. Go to Settings > Connectors.
  3. Click Add custom connector.
  4. Name it Shoal.
  5. Paste:
https://api.shoal.xyz/mcp
  1. Click Add.
  2. Click Connect.
  3. Claude opens the browser and redirects you to app.shoal.xyz.
  4. Sign in to Shoal if needed, then approve access.
  5. Return to Claude and enable Shoal from Search and tools.

​
Notes

  • The MCP client never needs the raw Shoal API key.
  • MCP usage is tracked against the same Shoal API key allocation as normal API usage.
  • For the hosted MCP flow itself, see Hosted MCP.