# Nango — how to use (mcp.ai)

Connect your Nango account and use 24 tools for developer tools straight from your AI agent. Connect with your own API key. Nango provides a unified API to integrate with over 250 external APIs, offering pre-built and customizable integrations for various categories such as CRM, HR, and accounting systems.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_nango?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `nango_action_trigger_post`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/nango`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/nango/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/nango/action/trigger/post` — Trigger a Nango action to execute a workflow or operation. Use this to run pre-defined actions in your Nango integrations, such as creating issues, sending messages, or fetching data from external API
  - body: { input?: object, action_name: string, connection_id: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/add/connection` — Tool to add a connection with existing credentials to Nango. Use when you want to bulk import existing access tokens into Nango.
  - body: { tags?: object, end_user?: object, metadata?: object, credentials: object, connection_id?: string, connection_config?: object, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/connection/get` — List all Nango connections without credentials. Use this to discover available connections, check connection status, and find connection IDs. Omitting all filters returns every connection across all i
  - body: { page?: integer, limit?: integer, search?: string, end_user_id?: string, connection_id?: string, end_user_organization_id?: string }
- `POST https://api.mcp.ai/api/nango/create/connect/session` — Tool to create a new connect session with a 30-minute lifespan for enabling connection creation via Connect UI. Use when you need to generate a session token for users to authorize integrations throug
  - body: { tags?: object, end_user: object, overrides?: object, organization?: object, allowed_integrations?: string[], integrations_config_defaults?: object }
- `POST https://api.mcp.ai/api/nango/create/integration` — Tool to create a new integration in Nango. Use when setting up a new provider connection configuration. Creates an integration with specified credentials (OAuth2, App-based, or Hybrid authentication).
  - body: { provider: string, unique_key: string, credentials?: object, display_name?: string }
- `POST https://api.mcp.ai/api/nango/delete/connection` — Tool to delete a specific Nango connection. Use when you need to remove an existing connection permanently.
  - body: { connection_id: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/delete/integration` — Tool to delete a specific integration by its unique key. Use when you need to remove an integration configuration from Nango.
  - body: { uniqueKey: string }
- `POST https://api.mcp.ai/api/nango/edit/connection` — Tool to edit a connection's tags and metadata. Use when you need to update connection attributes like environment tags, team assignments, or end user information.
  - body: { tags?: object, end_user?: object, connection_id: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/get/connection` — Retrieve a specific connection with its credentials. Automatically checks if the access token has expired and refreshes it if needed. Use this action when you need to access the authentication credent
  - body: { connection_id: string, force_refresh?: boolean, refresh_token?: boolean, provider_config_key: string, refresh_github_app_jwt_token?: boolean }
- `POST https://api.mcp.ai/api/nango/get/environment/variables` — Tool to retrieve environment variables from the Nango dashboard. Use when you need to access or list environment variables configured in Nango.
- `POST https://api.mcp.ai/api/nango/get/integration` — Retrieve detailed configuration for a specific Nango integration by its unique key. Returns integration details including provider, display name, creation/update timestamps, and optionally sensitive d
  - body: { include?: string[], unique_key: string }
- `POST https://api.mcp.ai/api/nango/get/proxy` — Tool to make a GET request with Nango's Proxy to forward requests to external APIs while managing authentication. Use when you need to make authenticated API calls to external services through Nango's
  - body: { retries?: integer, any_path: string, retry_on?: string, decompress?: boolean, query_params?: object, connection_id: string, custom_headers?: object, base_url_override?: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/get/sync/status` — Tool to get the status of specified sync(s) for a connection or all connections. Use when you need to monitor sync execution state, check completion times, or view sync frequency.
  - body: { syncs: string, connection_id?: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/list/connections` — Tool to list all connections without credentials. Use when you need to retrieve connection metadata across your account.
  - body: { page?: integer, tags?: object, limit?: integer, search?: string, endUserId?: string, connectionId?: string, endUserOrganizationId?: string }
- `POST https://api.mcp.ai/api/nango/list/integrations` — Tool to retrieve a list of all configured integrations. Use when you need to display or iterate through integrations in your account.
- `POST https://api.mcp.ai/api/nango/providers/get/get` — Retrieve detailed configuration for a specific Nango provider by its unique key. Returns provider authentication details (auth_mode, OAuth URLs), proxy configuration, required credentials schema, and 
  - body: { provider: string }
- `POST https://api.mcp.ai/api/nango/providers/list/get` — Tool to retrieve a list of all available providers. Use when you need to display or iterate through every provider before creating connections. The provider_config_key values returned must be used ver
- `POST https://api.mcp.ai/api/nango/put/proxy` — Tool to make a PUT request with the Nango Proxy to forward requests to external APIs while managing authentication. Use when you need to update resources via external APIs through Nango's proxy.
  - body: { body?: object, retries?: string, any_path: string, decompress?: string, connection_id: string, base_url_override?: string, additional_headers?: object, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/reconnect/session/post` — Create a new connect session to reconnect to a specific integration. Use this when a user needs to input new credentials or to manually refresh a token. Only connections created with a connect session
  - body: { tags?: object, end_user?: object, overrides?: object, organization?: object, connection_id: string, integration_id: string, integrations_config_defaults?: object }
- `POST https://api.mcp.ai/api/nango/scripts/config/get` — Retrieve all integration functions configuration from Nango. Returns the configuration for all integrations including their sync scripts, action scripts, and event handlers. Use this to discover avail
- `POST https://api.mcp.ai/api/nango/set/connection/metadata` — Tool to set custom metadata for one or more Nango connections. Use when you need to attach custom data (tags, labels, context) to connections for filtering, organization, or application-specific purpo
  - body: { metadata: object, connection_id: string|string[], provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/sync/trigger/post` — Tool to trigger sync process(es) manually. Use after establishing a connection and defining syncs. This triggers an additional, one-off execution of the specified sync(s) for a given connection or all
  - body: { syncs: string[], sync_mode?: string, connection_id?: string, provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/update/connection/metadata` — Tool to edit custom metadata for one or multiple connections. Use when you need to update specific metadata properties without overwriting the entire metadata object.
  - body: { metadata: object, connection_id: string|string[], provider_config_key: string }
- `POST https://api.mcp.ai/api/nango/update/integration` — Tool to update an existing integration's configuration. Use when you need to modify an integration's display name, unique key, or credentials.
  - body: { unique_key: string, credentials?: object, display_name?: string, new_unique_key?: string }

## Example prompts
- "What can I do in Nango?"
- "Show me a summary of my Nango account"

## More
- Page: https://mcp.ai/nango
- Agent spec (llms.txt): https://mcp.ai/nango/llms.txt
- Postman collection: https://mcp.ai/nango/postman.json