Custom APIs and MCP servers · Cursor & VS Code
Connect Custom API to Cursor & VS Code
Connect any REST API, from your own app to a tool without a connector, and let your AI read it and, with your approval, change it. Plugsight links Custom API to Cursor & VS Code in a few minutes, with no code and no exports.
What you can ask Cursor & VS Code about Custom API
How to connect Custom API to Cursor & VS Code
- Create a free Plugsight account.
- Choose Custom API, enter the API's https address and how it signs in (an API key, a bearer token, a username and password, or OAuth client credentials). Optionally import its OpenAPI spec so each endpoint becomes its own tool.
Then add Plugsight to Cursor & VS Code
- In Plugsight, open MCP servers, create one and copy its URL. For VS Code and Gemini CLI, also create an API key on the server's page.
- Cursor: add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), save, then sign in to Plugsight and click Allow access when the browser opens:
{"mcpServers": {"plugsight": {"url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID"}}} - If no browser window opens in Cursor, add an API key instead: put it in an environment variable called PLUGSIGHT_API_KEY and add "headers": {"Authorization": "Bearer ${env:PLUGSIGHT_API_KEY}"} next to the url.
- VS Code (Copilot agent mode): add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely:
{"inputs": [{"type": "promptString", "id": "plugsight-key", "description": "Plugsight API key", "password": true}], "servers": {"plugsight": {"type": "http", "url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer ${input:plugsight-key}"}}}} - Gemini CLI: add this to ~/.gemini/settings.json
{"mcpServers": {"plugsight": {"httpUrl": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}} - Reload the tool and ask its agent to use the Plugsight tools.
Cursor signs in to Plugsight in your browser. VS Code, Gemini CLI and other clients connect with your MCP server's URL and an API key. Works with any client that supports remote MCP servers over HTTP.
Full steps and troubleshooting in the docs: Cursor, VS Code, Other MCP apps.
Custom API data available
- Any GET request under the address you connect, with JSON answers read for your AI
- Each endpoint of an imported OpenAPI 3 or Swagger 2.0 spec as its own tool, with its parameters and body (up to 50 per API)
- A searchable list of every imported endpoint, for larger APIs (up to 300)
- POST, PUT, PATCH and DELETE requests, when you allow changes and approve each one
Why use Custom API in Cursor & VS Code
- Use business data inside your editor
- Build dashboards and scripts on real numbers
- One server for many tools
Questions about Custom API and Cursor & VS Code
How do I connect Custom API to Cursor & VS Code?
Create a free Plugsight account and connect Custom API: Choose Custom API, enter the API's https address and how it signs in (an API key, a bearer token, a username and password, or OAuth client credentials). Optionally import its OpenAPI spec so each endpoint becomes its own tool. Then add Plugsight to Cursor & VS Code: In Plugsight, open MCP servers, create one and copy its URL. For VS Code and Gemini CLI, also create an API key on the server's page. Cursor: add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project), save, then sign in to Plugsight and click Allow access when the browser opens: {"mcpServers": {"plugsight": {"url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID"}}} If no browser window opens in Cursor, add an API key instead: put it in an environment variable called PLUGSIGHT_API_KEY and add "headers": {"Authorization": "Bearer ${env:PLUGSIGHT_API_KEY}"} next to the url. VS Code (Copilot agent mode): add this to .vscode/mcp.json. VS Code asks for the key once and stores it securely: {"inputs": [{"type": "promptString", "id": "plugsight-key", "description": "Plugsight API key", "password": true}], "servers": {"plugsight": {"type": "http", "url": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer ${input:plugsight-key}"}}}} Gemini CLI: add this to ~/.gemini/settings.json {"mcpServers": {"plugsight": {"httpUrl": "https://app.plugsight.app/mcp/YOUR_SERVER_ID", "headers": {"Authorization": "Bearer YOUR_API_KEY"}}}} Reload the tool and ask its agent to use the Plugsight tools.
Can Cursor & VS Code read my Custom API data?
Yes, once connected. Cursor & VS Code can see: Any GET request under the address you connect, with JSON answers read for your AI; Each endpoint of an imported OpenAPI 3 or Swagger 2.0 spec as its own tool, with its parameters and body (up to 50 per API); A searchable list of every imported endpoint, for larger APIs (up to 300); POST, PUT, PATCH and DELETE requests, when you allow changes and approve each one. For example, ask: "Using our internal API, list the customers who signed up this week."
Which Cursor, VS Code & other MCP clients plans work?
Works with any client that supports remote MCP servers over HTTP.
How does Cursor & VS Code sign in to Plugsight?
Cursor signs in to Plugsight in your browser. VS Code, Gemini CLI and other clients connect with your MCP server's URL and an API key.
Can Cursor & VS Code change anything in Custom API?
Only if you allow it. Reading is always on; sending or making changes is off until you switch it on for this connection and your MCP server, and each action then needs your approval in the chat.
Is the Custom API connector free?
Custom API is on the Pro plan ($29 a month, or $290 a year), which also adds more connections and the marketing sources. The Free plan covers email, helpdesk, calendar, contacts, files, stores and email marketing.
Good to know
- Only public https addresses: Plugsight never calls private or local networks, and never follows redirects.
- Keys, tokens, passwords and extra headers are encrypted, and cut from anything your AI sees.
- Reading (GET) is always on; changes are off until you allow them, and each one waits for your approval in the chat.
Related guides
Connect Custom API to Cursor & VS Code
Free plan, no credit card. Set up in about five minutes.
Updated