Gooshi Developer Docs
MCP Servers

Connection requirements

Prepare an MCP endpoint for a reliable Gooshi connection.

Before connecting an MCP server, confirm:

  • The endpoint uses Streamable HTTP and is reachable from the internet.
  • TLS is valid and the URL uses HTTPS in production use.
  • The server responds within a reasonable time.
  • Tool names are stable and unique within the server.
  • Tool input schemas are valid and describe required inputs.
  • The MCP Owner has permission to route calls through Gooshi.

Design for predictable operation

Tool calls should return clear success or error responses. Avoid changing a tool's meaning without also updating its name or schema; triggers and reports are easier to understand when tool contracts stay stable.

After an upstream release that changes tools or schemas, use Refresh tools and review any affected triggers before sharing the wrapped endpoint again.

For connection failures, see MCP connection troubleshooting.

On this page