Skip to content

Jentic MCP + Windsurf

Goal — In a few minutes, you'll enable Jentic MCP tools in Windsurf using either API Key or OAuth authentication, allowing you to search, load, and execute external APIs directly in your coding workflow.

What you'll get

With Jentic MCP configured in Windsurf, you'll gain access to powerful tools:

Tools available

Tool available in Windsurf What it does
search_apis Type what you need (e.g., "Send Discord Message", "Find New York Times Articles") and MCP lists matching APIs.
load_execution_info See the details of any API you found - what information it needs and how to use it.
execute Actually use the API - provide the required information and get results back in the chat.

Resources available

Resource available in Windsurf What it does
list_credentials Lists all credentials your agent has access to in .txt format. Can be given to the agent for more context about available integrations.

Before you start

  • Windsurf — Latest version (update if needed to support OAuth)
  • Jentic account — Sign in at app.jentic.com
  • MCP Configuration set (for OAuth) — Create an MCP Configuration set in Jentic
  • Agent API Key (for API Key auth) — Create a Live Capabilities agent and get your API key

Choose Your Authentication Method

Windsurf supports both OAuth and API Key authentication. Choose the method that works best for you:

  • OAuth (recommended) — Token-based authentication stored in the client. No API key needed. Sign in once and the client handles authentication. Full functionality (search, load, execute).
  • API Key — Use your Agent API Key for authentication. Requires creating a Live Capabilities agent in Jentic. Full functionality (search, load, execute).

OAuth Configuration

1. Sign In to Jentic

  1. Go to app.jentic.com/sign-in in your browser.
  2. Sign in to your Jentic account.
  3. Make sure you use the same sign-in method you'll use when connecting to MCP later.

2. Set Up MCP Configuration Set

  1. Go to app.jentic.com/mcp-configuration in your browser.
  2. Click to create a new MCP Configuration set.
  3. Choose the integrations you want to use with MCP.
  4. Add any necessary credentials (API keys, OAuth tokens, etc.) to the MCP Configuration set.
  5. Save your MCP Configuration set.

3. Configure Windsurf

  1. Open Windsurf.
  2. If the Cascade chat UI doesn't appear, click the W Windsurf logo in the center of the top navigation bar.
  3. Click the ... icon (shows "actions" on hover).
  4. Click Open MCP Config file.
  5. Replace the entire contents of mcp_config.json with the OAuth configuration below:
{
  "mcpServers": {
    "jentic": {
      "disabled": false,
      "headers": {},
      "serverUrl": "https://api.jentic.com/mcp"
    }
  }
}
  1. Save the configuration file.

4. You're All Set

You're now connected! You can use the Jentic MCP Server in Windsurf's chat interface.

API Key Configuration

1. Sign In to Jentic

  1. Go to app.jentic.com/sign-in in your browser.
  2. Sign in to your Jentic account.

2. Create a Live Capabilities set & Get Your API Key

  1. Go to app.jentic.com/live in your browser.
  2. Click New Live Capabilities.
  3. Choose a name for your Live Capabilities set.
  4. Add any relevant credentials (API keys, OAuth, etc.) that you want the Live Capabilities agent to use.
  5. Click Create Live Capabilities.
  6. Copy your Agent API Key (shown only once — save it securely).

3. Configure Windsurf

  1. Open Windsurf.
  2. If the Cascade chat UI doesn't appear, click the W Windsurf logo in the center of the top navigation bar.
  3. Click the ... icon (shows "actions" on hover).
  4. Click Open MCP Config file.
  5. Replace the entire contents of mcp_config.json with the API Key configuration below:
{
  "mcpServers": {
    "jentic": {
      "disabled": false,
      "headers": {
        "x-jentic-api-key": "your_agent_api_key"
      },
      "serverUrl": "https://api.jentic.com/mcp"
    }
  }
}
  1. Replace "your_agent_api_key" with your actual API key from step 2 (Create a Live Capabilities set & Get Your API Key).
  2. Save the configuration file.

4. You're All Set

You're now connected! To use Jentic MCP:

  1. Open Windsurf's chat interface.
  2. Start using Jentic tools - the connection will be established automatically.
  3. Begin your query with "Use Jentic to …" to use the tools.