Skip to content

AI Agents

Cursor

The AI code editor, whose agent can use MCP tools.

Connects with
Sign in, API key, Skill

Before you start

  • A SPREVA account, with access to the workspace you want to connect.
  • A version of Cursor that can add a connector or an MCP server by URL.

Set it up

  1. 1

    Open ~/.cursor/mcp.json to use SPREVA in every project, or .cursor/mcp.json inside one project.

  2. 2

    Add SPREVA to it:

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "spreva": {
          "url": "https://app.spreva.ai/api/mcp"
        }
      }
    }
  3. 3

    In Cursor, open Customize, then MCPs, and follow the sign-in prompt next to spreva. SPREVA opens: sign in, choose the workspace and click Allow.

  4. 4

    Ask the Agent for something in SPREVA.

Also works with

  • API key in a header

    Send a SPREVA API key as a Bearer token, for automation that runs without a person.

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "spreva": {
          "url": "https://app.spreva.ai/api/mcp",
          "headers": {
            "Authorization": "Bearer ${env:SPREVA_API_KEY}"
          }
        }
      }
    }
  • The CLI and the Agent Skill

    Install the spreva command line and its Agent Skill, for agents that work in a terminal.

    Terminal
    export SPREVA_API_KEY=spreva_sk_...
    npx -y @spreva/cli skill install --target agents

Check it works

Start a new conversation and ask:

Ask your agent
What's going out this week on SPREVA?

Cursor calls SPREVA's overview tool and answers with the workspace's time zone, what goes out next and anything that needs attention. The first time, Cursor may ask you to allow the tool.

Troubleshooting

The chat doesn't use SPREVA

Cursor's Agent uses MCP tools when they fit the request. Check that SPREVA's tools are on in the tools list at the top of the chat panel, or name SPREVA in your request.

SPREVA works in one project only

It is in that project's .cursor/mcp.json. Move it to ~/.cursor/mcp.json to have it everywhere.

Something else? Troubleshooting covers sign-in loops, plans, limits and time zones.