list and can give its tools to their genies, but only the person who added it (or an admin) can rename it, sign in again or delete it.
Saved sign-ins and tokens are never returned by any action.
The connection object
"connected"— ready to use."pending"— the sign-in was never finished. Callauthorizefor a new sign-in link."reconnect"— the server stopped accepting the sign-in or token. Callauthorize(OAuth) or replace the token withupdate.
true when the caller added the connection. false for a teammate’s connection, which can be given to genies but not changed.List connections
Returns the MCP servers the caller and their teammates connected, newest first, each with its status and the genies using it.Create a connection
Connects an MCP server to the caller’s account. WithauthType: "auto" (the default), the server says whether it needs a sign-in: one that does gets an OAuth connection and the response includes the sign-in link to open in the browser; one that doesn’t is connected straight away.
Token, header and open connections are checked by listing the server’s tools before they are saved. If that fails, nothing is saved and the request returns VALIDATION_ERROR.
An OAuth sign-in can only be started from the Help Genie app: the server sends the user back to
/genie-hub/connections/mcp/callback, which calls callback. The sign-in link works for 15 minutes. A server that needs a sign-in, connected from outside the app, returns VALIDATION_ERROR.Get a sign-in link
Returns a new sign-in link for an OAuth connection: to finish connecting it, or to connect it again after it stopped working. Genies using the connection keep working with the new sign-in. Only the person who added the connection (or an admin). Must be called from the Help Genie app. Connections without OAuth returnVALIDATION_ERROR; replace their token with update instead.
Finish a sign-in
Finishes an OAuth sign-in with thecode and state the server sent back to the callback page. Must be called by the person who started the sign-in, within 15 minutes. An expired or mismatched state returns VALIDATION_ERROR.
List a server’s tools
Returns the tools the server offers right now, to pick which ones a genie may use. Works for your own and your teammates’ connections. The connection must be"connected".
Update a connection
Renames a connection, or replaces the token of abearer or header connection. A new token clears the "reconnect" status. Only the person who added the connection (or an admin). Pass at least one of name or token.
Delete a connection
Deletes a connection and its saved sign-in. Every genie using it loses its tools. Only the person who added the connection (or an admin).The link object
A link gives one genie a set of one connection’s tools.The connection.
List a genie’s connections
Returns the MCP connections a genie uses, oldest first, each with the tools it may call. Requires access to the genie.Give a genie tools
Gives a genie some of a connection’s tools. The genie can call only the tools listed, and each must be a tool the server offers now. The connection must be"connected" and can be your own or a teammate’s. A genie can have each connection once: if it already uses this one, the request returns CONFLICT — change its tools with genie-update instead.

