Cursor Setup

Connect Cursor IDE to your Cognova workspace via MCP for full agent swarm access, task management, and knowledge retrieval.

Configuration

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "cognova": {
      "url": "https://cognova.dev/mcp",
      "headers": {
        "Authorization": "Bearer cg_YOUR_KEY"
      }
    }
  }
}

Replace cg_YOUR_KEY with your API key from Settings > API Keys.

Verify Connection

After saving the config:

Restart Cursor (or reload the window)
Open the MCP panel — you should see "cognova" listed
The available tools will appear: cognova_list_agents, cognova_ask_agent, etc.

Available Tools

Once connected, Cursor can use all Cognova MCP tools:

cognova_list_agents — Discover workspace agents
cognova_ask_agent — Ask any agent a question
cognova_list_tasks / cognova_create_task — Manage tasks
cognova_recall / cognova_remember — Search and store memories
cognova_list_knowledge / cognova_get_knowledge — Browse knowledge files

See the full MCP Server docs for details on all tools and resources.

Tips

Use one API key per project so you can revoke individually
Cursor auto-discovers tools on connection — no manual registration needed
The MCP session has a 30-minute idle timeout; Cursor reconnects automatically

Troubleshooting

Tools not appearing?

Ensure .cursor/mcp.json is in the project root
Check that the API key is valid (hasn't been revoked)
Restart Cursor after adding the config

Authentication errors?

Verify the key starts with cg_
Check for extra whitespace in the JSON
Generate a new key if the current one may have expired