Skip to main content
The Grunt MCP Server uses streamable HTTP and OAuth authentication.

Add the server to your client

1

Open your client's MCP settings

Add a remote MCP server. The exact name of this setting depends on your client.
2

Enter the Grunt MCP URL

3

Sign in to Grunt

Connect the server. Your client opens the authorization flow and prompts you to sign in.
4

Approve access

Complete the authorization flow. Your client can then discover and call the available tools.
Your MCP client must support OAuth for remote MCP servers.

OAuth metadata

Clients can discover the server’s protected resource metadata at:
The response includes:
  • resource
  • authorization_servers
  • scopes_supported
The server currently advertises the openid, profile, and email scopes.

Test an authenticated connection

If you already have a valid access token, you can request the current tool list directly:
Include both application/json and text/event-stream in the Accept header when calling the MCP endpoint directly.

Troubleshooting

  • A 401 Unauthorized response means the request does not include a valid access token. Reconnect the server and complete sign-in.
  • If the server does not appear in your client, confirm that the client supports remote MCP servers over streamable HTTP.
  • If tool discovery fails after sign-in, remove the connection and add it again to refresh authorization.