Skip to main content
This guide walks you through setting up the emma MCP Server in Cursor.

​
Prerequisites

Before you begin, make sure you have:
  • Cursor installed on your machine
  • An emma account with API access
  • Your emma API Key (available in Settings)

​
Configuration

​
Step 1: Get Your API Key

  1. Log in to emma
  2. Go to Settings
  3. Copy your API Key

​
Step 2: Configure Cursor

Add the emma MCP server to your Cursor configuration file.
Edit ~/.cursor/mcp.json:
{
  "mcpServers": {
    "emma": {
      "command": "python",
      "args": ["-m", "emma_mcp"],
      "env": {
        "EMMA_API_KEY": "your_api_key_here"
      }
    }
  }
}
Replace your_api_key_here with your actual emma API Key. Never commit your API key to version control.

​
Step 3: Restart Cursor

After saving the configuration file, restart Cursor to load the MCP server.

​
Verify the Connection

To verify that emma MCP Server is working correctly, you can use the health check tool:
  1. Open Cursor
  2. In the AI chat, ask: “Check emma connection status”
  3. The emma_health_check tool should return a successful response

​
Configuration Options

​
Environment Variables

VariableRequiredDescription
EMMA_API_KEYRequiredYour emma API key

​
Troubleshooting

​
Server Not Starting

Make sure Python is installed and available in your PATH. You can verify by running:
python --version
If Python is not found, install it from python.org.
Ensure the emma MCP package is installed correctly. Contact support if you need assistance with installation.
Double-check that your API key is correct and hasn’t expired. You can generate a new key from emma Settings.

​
Connection Issues

  1. Verify your internet connection
  2. Check that your API key is valid
  3. Ensure there are no firewall rules blocking the connection
  1. Restart Cursor completely
  2. Check the MCP configuration file for syntax errors
  3. Verify the server name matches exactly: emma

​
Security Best Practices

1

Use Environment Variables

Instead of hardcoding your API key, consider using environment variables:
{
  "mcpServers": {
    "emma": {
      "command": "python",
      "args": ["-m", "emma_mcp"],
      "env": {
        "EMMA_API_KEY": "${EMMA_API_KEY}"
      }
    }
  }
}
Then set the environment variable in your shell profile.
2

Restrict API Key Permissions

If emma supports scoped API keys, use a key with only the permissions you need.
3

Rotate Keys Regularly

Periodically generate new API keys and revoke old ones.

​
Next Steps

emma MCP Server

Learn about available tools and use cases

Tools Reference

Detailed documentation for all tools