integrations

Finish a Smokeball connection (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
GET /legal/smokeball/callback
Access token

Where Smokeball sends the browser back after the user authorizes; it needs no sign-in, the state value ties it to the connect request. Saves the connection and redirects (302) to the portal with smokeball=connected. Returns 401 when code or state is missing and 403 while the Smokeball integration is turned off.

Query parameters

  • code string Required
  • state string Required

Responses

  • 302

    Redirects (Location header) to the portal with smokeball=connected.

GET /legal/smokeball/callback 
curl \
 --request GET 'http://api.example.com/legal/smokeball/callback?code=string&state=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN"