Nango MCP server
35 operations0 webhooks
Manage Nango integrations, connections, Connect sessions, syncs and synced records, call tools, and proxy requests to your end users' APIs.
Try Nango with your agent
Connect Nango, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in Nango on my account, then run one read-only example and show me the result.
Nango tools and triggers
Tools are what your agent can do in Nango through Corsair's MCP server. Triggers are the Nango events a routine can start from.
Connections
- DeleteDestructive
Delete a connection and its stored credentials.
connections.delete
- GetRead-only
Get one connection. Pass include_credentials: true to also return its live third-party credentials (access token, API key, password); they are dropped otherwise.
connections.get
- ImportDestructive
Create a connection from credentials you already hold, or overwrite an existing connection's credentials when connection_id matches. The credentials are not returned.
connections.import
- ListRead-only
List connections (no credentials), filtered by connection ID or tags, with page and limit.
connections.list
- PatchWrite
Edit a connection: replace its tags or set a webhook URL override.
connections.patch
- Set MetadataDestructive
Replace the whole metadata object of one or more connections; keys not passed are removed.
connections.setMetadata
- Update MetadataWrite
Merge keys into the metadata of one or more connections.
connections.updateMetadata
Integrations
- CreateWrite
Create an integration for a provider, optionally with developer app credentials or integration_config.
integrations.create
- DeleteDestructive
Delete an integration and every connection that uses it.
integrations.delete
- GetRead-only
Get an integration. include: ["credentials"] also returns the developer app client secret and private key.
integrations.get
- ListRead-only
List the integrations configured in this environment.
integrations.list
- UpdateWrite
Edit an integration; fields left out keep their value.
integrations.update
Proxy
- DeleteDestructive
Send a DELETE through Nango's proxy to the end customer's API with the connection's credentials.
proxy.delete
- GetRead-only
Send a GET through Nango's proxy to the end customer's API with the connection's credentials.
proxy.get
- PatchDestructive
Send a PATCH through Nango's proxy to the end customer's API with the connection's credentials.
proxy.patch
- PostDestructive
Send a POST through Nango's proxy to the end customer's API with the connection's credentials.
proxy.post
- PutDestructive
Send a PUT through Nango's proxy to the end customer's API with the connection's credentials.
proxy.put
Syncs
- PauseWrite
Pause the schedule of syncs for one connection or all.
syncs.pause
- StartWrite
Start the schedule of syncs for one connection or all; they run now and then on their frequency.
syncs.start
- StatusRead-only
Get the status, schedule, last result and record counts of syncs.
syncs.status
- TriggerWrite
Run syncs once now, for one connection or all; reset starts from scratch.
syncs.trigger
- Update FrequencyWrite
Override a sync's frequency for one connection, or restore the default with null.
syncs.updateFrequency
Functions
- DeleteDestructive
Delete a deployed function, e.g. a catalog sync enabled in the dashboard; functions deployed from a repo with the nango CLI cannot be deleted here.
functions.delete
- GetRead-only
Get one function of an integration, with its schema and deployment state.
functions.get
- Get CodeRead-only
Get a function's TypeScript source code.
functions.getCode
- ListRead-only
List an integration's functions (syncs, tools, on-event functions), including Nango catalog tools.
functions.list
Providers
- GetRead-only
Get one provider's auth mode, proxy settings and required connection fields.
providers.get
- ListRead-only
List the APIs Nango supports; filter with search (the full list has over 1,000).
providers.list
Sessions
- CreateWrite
Create a Connect session; returns a short-lived token and a connect link an end user opens to authorize an integration.
sessions.create
- ReconnectWrite
Create a Connect session that re-authorizes an existing connection, keeping its connection ID.
sessions.reconnect
Actions
- TriggerDestructive
Run a legacy action for a connection synchronously. Actions can write to the end customer's account.
actions.trigger
Environment
- Get VariablesRead-only
Get the environment variables set in the Nango dashboard, values in plain text (they often hold secrets).
environment.getVariables
Records
- ListRead-only
List the records a sync stored for a connection and model, paginated with next_cursor.
records.list
Scripts
- Get ConfigRead-only
Get the configuration of every deployed function in the environment, in Nango or OpenAI tool format.
scripts.getConfig
Tools
- CallDestructive
Call a deployed tool for a connection and return its output. Tools can write to the end customer's account.
tools.call
Connect Nango to Claude, ChatGPT or Cursor
- 1
Connect Nango in Corsair
Add your Nango API key once in Corsair. Corsair stores the credential encrypted and makes the Nango API calls for your agent, so it never goes into a prompt or a config file. Connect Nango
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs Nango. On a ChatGPT personal plan, connect Nango here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, Nango's read and write operations run right away and its 11 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/nango, add the Nango plugin, and connect with an API key. Then call methods like corsair.nango.api.actions.trigger() from your app. Corsair keeps each tenant isolated.
Yes. Nango requires an API key from your Nango account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit Nango, GitHub, Notion, Stripe, and the rest. Trigger Nango from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for manage Nango integrations, connections, Connect sessions, syncs and synced records, call tools, and proxy requests to your end users' APIs. Common builds include sync jobs, admin tooling, and agents that call Nango APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per Nango API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/nango in the open repo. When Nango ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your Nango data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store Nango data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put Nango on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 11 destructive Nango operations. You can change a link's mode at hub.corsair.dev/me.