Jentic MCP + Cursor¶

Goal — In a few minutes, you'll enable Jentic MCP tools in Cursor, allowing you to search, load, and execute external APIs directly in your coding workflow.

What you'll get¶

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

Tools available¶

Before you start¶

Ensure you have the following:

1. Create an Agent & get your Agent API Key¶

1. Go to app.jentic.com/sign-in and sign in to your account.
2. In Credentials, add any API secrets you'll use (e.g., Discord bot token, NYT key). These credentials will be securely stored in Jentic and automatically used by your agent.

3. Open Agents → New Agent, select which APIs/workflows this agent can access, then Generate API Key.

4. Keys are scoped to the APIs you selected and shown once.

5. Recommended: Store all API credentials in Jentic's Credentials section rather than using environment variables.
6. Set the Agent API Key as an environment variable so Cursor can pass it to the MCP server:

macOS / Linux

export JENTIC_AGENT_API_KEY="<your-agent-api-key>"

Windows (PowerShell)

setx JENTIC_AGENT_API_KEY "<your-agent-api-key>"
$env:JENTIC_AGENT_API_KEY = "<your-agent-api-key>"  # current session

✅ No more jentic register, curl, or JENTIC_UUID. Use JENTIC_AGENT_API_KEY from the Agents page.

2. Configure Cursor to use Jentic MCP¶

1. Open Cursor.

2. Access your Cursor MCP configuration file (mcp.json):

   The easiest way to open (or create if it doesn't exist) your mcp.json is through the Cursor interface:

   • Via Cursor's Settings UI (Recommended Method):
     1. Click the cog wheel (⚙️) in the top right of the Cursor application.
     2. Select MCP from the sidebar.
     3. Click "Add new global MCP server".
     4. This will open (or create) your mcp.json file in your default text editor.

   If you prefer, or if the UI method isn't available, you can manually find and open the file:

   macOS/Linux: ~/.cursor/mcp.json

   • Terminal:

     mkdir -p ~/.cursor
     open ~/.cursor/mcp.json
     

   • File Manager:
     • Go to your home directory, show hidden files, open .cursor/mcp.json (create if missing).

   Windows: %USERPROFILE%\.cursor\mcp.json

   • File Explorer: paste %USERPROFILE%\.cursor\ in the address bar, create mcp.json if missing.
   • PowerShell:

     notepad $env:USERPROFILE\.cursor\mcp.json
     

3. Add or update the Jentic MCP server configuration: Paste the following JSON into your mcp.json file. If the file already contains an mcpServers object with other servers, carefully add the jentic entry within it, ensuring correct JSON formatting.

{
  "mcpServers": {
    "jentic": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp",
        "mcp"
      ],
      "env": {
        "JENTIC_AGENT_API_KEY": "<your-agent-api-key>"
      }
    }
  }
}

1. Save the mcp.json file.

2. Restart Cursor for the changes to take effect.

3. Managing API Credentials¶

Recommended approach: Store all API credentials in Jentic's Credentials section when creating your agent. This keeps credentials secure and centralized.

If you need to add credentials for APIs you want to use: 1. Go back to app.jentic.com and sign in. 2. Navigate to Credentials and add any additional API keys, tokens, or secrets needed. 3. Update your agent to include the new credentials, or create a new agent with the updated credentials.

Note: Only the JENTIC_AGENT_API_KEY should be set as an environment variable. All other API credentials should be stored in Jentic's Credentials section, not as environment variables in your MCP configuration.

Optional: Using Environment Variables¶

If you prefer to use environment variables directly instead of storing credentials in Jentic, you can add them to your MCP configuration:

1. Open the same mcp.json file.
2. Insert or update the env block inside the jentic server.
3. Save the file and restart Cursor.

Example configuration with environment variables:

{
  "mcpServers": {
    "jentic": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/jentic/jentic-sdks.git@main#subdirectory=mcp",
        "mcp"
      ],
      "env": {
        "JENTIC_AGENT_API_KEY": "<your-agent-api-key>",
        "DISCORD_BOTTOKEN": "<your-discord-bot-token>",
        "OPENAI_API_KEY": "<your-openai-api-key>"
      }
    }
  }
}

Security tip: The mcp.json file is plain text. Ensure it's stored securely, especially if it contains sensitive API keys.

4. If something doesn't work¶

Making Cursor See uvx¶

Cursor, like many applications, might not automatically pick up binaries added to your shell's PATH via files like .zshrc or .bashrc. Choose one of these options:

Option A – Homebrew / System package (macOS & Linux)¶

• Homebrew (macOS) or your distro’s package manager / a sudo pip install uv drops uvx somewhere Cursor already looks:
  • /usr/local/bin on Intel Macs & most Linux distros
  • /opt/homebrew/bin on Apple Silicon

If which uvx returns a path, you’re good – skip this section.

Option B – pip / pipx / pyenv (user-local installs)¶

If uvx lives in a user-local directory, expose it via a symlink (macOS/Linux) or by adding the folder to PATH (Windows).

• macOS / Linux – symlink

  sudo ln -sf "$(which uvx)" /usr/local/bin/uvx   # use /opt/homebrew/bin on Apple Silicon
  sudo ln -sf "$(which uv)"  /usr/local/bin/uv
  

• Windows – PATH
  1. Locate the folder containing uvx.exe (e.g. %USERPROFILE%\AppData\Roaming\Python\Python311\Scripts).
  2. Add that folder to Path in Environment Variables….
  3. Restart Cursor (and any open terminals).

Option C – Hard-code the full path¶

Skip PATH tweaks entirely and set the absolute path to uvx / uvx.exe in the command field of mcp.json.

Contact Us Next