Cursor MCP Setup
Connect xSeek AI SEO tools directly to Cursor IDE using Model Context Protocol (MCP)
Contents
Overview
The Model Context Protocol (MCP) allows you to integrate xSeek's powerful AI SEO tools directly into Cursor IDE. This enables you to access AI search analytics, website management, and prompt tracking without leaving your development environment.
Direct Access
Access all xSeek tools directly from Cursor's AI assistant without switching between applications.
Secure Authentication
Uses API key authentication to securely connect to your xSeek account and data.
Requirements
Before You Begin
- ✓Cursor IDE: Installed on your machine (download here)
- ✓xSeek Account: Active subscription (any plan)
- ✓File System Access: Ability to create/edit configuration files
Quick Start
Follow these steps to set up xSeek MCP in Cursor in just a few minutes:
Create API Key
Log in to your xSeek account and navigate to the API Keys section to generate a new API key.
See Detailed Steps →Create Configuration File
Create or edit the MCP configuration file in your home directory.
View Configuration →Restart Cursor
Completely restart Cursor IDE to load the new MCP configuration and activate xSeek tools.
API Key Generation
Step 1: Access Your Dashboard
Log in to your xSeek account and navigate to your dashboard.
Go to DashboardStep 2: Navigate to API Keys
In your dashboard, look for the "API Keys" section in the settings or developer options menu.
Path: Dashboard → Settings → API Keys
Step 3: Generate New API Key
Click the "Generate API Key" or "Create New Key" button. Give your key a descriptive name like "Cursor MCP Integration".
Important: Copy your API key immediately! For security reasons, you won't be able to see it again after creation. Store it securely in a password manager or secure note.
Step 4: Store Your API Key Securely
Keep your API key safe and never share it publicly or commit it to version control. Treat it like a password.
- ✓ Store in a password manager
- ✓ Use environment variables when possible
- ✗ Never commit to Git repositories
- ✗ Never share in public channels
Configuration
Create MCP Configuration File
You need to create or edit the MCP configuration file in the .cursor directory of your home folder.
File Location:
~/.cursor/mcp.jsonAlternative Paths:
- macOS/Linux:
/Users/YOUR_USERNAME/.cursor/mcp.json - Windows:
C:\Users\YOUR_USERNAME\.cursor\mcp.json
Tip: If the .cursor directory doesn't exist, create it manually in your home directory.
Configuration Format
Add the following JSON configuration to your mcp.json file:
{
"mcpServers": {
"xSeek": {
"url": "https://www.xseek.io/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}Configuration Parameters:
mcpServers- Container for all MCP server configurationsxseek- Identifier for the xSeek MCP serverurl- Endpoint for the xSeek MCP API (use localhost:3000 for local development)Authorization- Bearer token with your API key
Replace Placeholder Values
Make sure to replace YOUR_API_KEY_HERE with your actual API key that you generated in the previous step.
Example with API Key:
"Authorization": "Bearer xs_1234567890abcdefghijklmnopqrstuvwxyz"Production vs Development
The configuration above uses localhost:3000 for local development. For production environments, use the production URL:
{
"mcpServers": {
"xSeek": {
"url": "https://www.xseek.io/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY_HERE"
}
}
}
}Testing Your Setup
Verify Configuration
After setting up the configuration and restarting Cursor, verify that the xSeek tools are available:
- 1.Open Cursor's AI assistant panel
- 2.Look for xSeek tools in the available MCP tools list
- 3.Try a simple command like "Get my websites from xSeek"
Example Test Commands
Try these commands in Cursor's AI assistant to test your setup:
"Show me all my websites in xSeek"
"Scan the robots.txt for https://example.com"
"Generate an LLMs.txt file for my website"
Success!
If you see responses from xSeek tools, your setup is complete! You can now use all xSeek features directly within Cursor.
Troubleshooting
Tools Not Appearing
If xSeek tools don't appear in Cursor after setup:
- Verify the
mcp.jsonfile is in the correct location - Check that the JSON syntax is valid (use a JSON validator)
- Ensure there are no typos in the configuration
- Completely quit and restart Cursor (not just reload window)
- Check Cursor's console/logs for error messages
Authentication Errors
If you receive authentication or authorization errors:
- Verify your API key is correct and hasn't expired
- Check that "Bearer " prefix is included in the Authorization header
- Ensure there are no extra spaces or line breaks in the API key
- Confirm your xSeek account has an active subscription
- Try generating a new API key if the current one isn't working
Connection Issues
If you can't connect to the xSeek MCP server:
- For local development: Ensure your xSeek development server is running on port 3000
- For production: Verify your internet connection is stable
- Check if there are any firewall rules blocking the connection
- Try the alternative URL (production vs localhost) to isolate the issue
File Permission Issues
If you can't create or edit the mcp.json file:
- Check file permissions on the .cursor directory
- Try creating the directory manually if it doesn't exist
- On Unix systems, ensure you have write permissions:
chmod 755 ~/.cursor - On Windows, run your text editor as administrator if needed
Still Having Issues?
If you've tried the troubleshooting steps above and still can't get MCP working, our support team is here to help.
Contact SupportNext Steps
Now that you have xSeek MCP set up in Cursor, explore more capabilities:
