# Cursor MCP

The Aikido MCP Plugin connects Aikido’s security engine to AI coding tools. It automatically scans AI generated code for vulnerabilities and hardcoded secrets as soon as it is created.

AI assistants can review their own output, but that review is not perfect. Aikido adds a reliable and consistent security layer that checks every generated snippet with proven scanning rules.

**Why use Aikido MCP**

* Deterministic, independent security checks on every AI generated snippet before it is committed
* Immediate detection and remediation of vulnerabilities and hardcoded secrets in AI assisted workflows
* Real time feedback, making AI driven development safer by default

### Available Tools

* **aikido\_full\_scan**: Scans local code files for vulnerabilities (SAST) and hardcoded secrets.
* **aikido\_issues\_list**: Fetches security issues from your Aikido feed.
  * **Filter by one scope:** repo\_name, cloud\_name, vm\_name, domain\_name, or container\_name 
  * **Pick one or more issue types:** sast, leaked\_secret, iac, open\_source, cloud, cloud\_instance, docker\_container, malware, eol, mobile, surface\_monitoring, scm\_security, license, ai\_pentest 
  * **Returns each issue** with title, type, severity, and remediation steps

## Installation

### Via Aikido IDE Expansion Packs (recommended)

The easiest way to add the Aikido MCP to Cursor is through the Aikido IDE plugin's Expansion Packs. This handles configuration automatically without any manual setup.

{% content-ref url="/pages/Hw5GlWQTBPXSiaAbs9uy" %}
[Cursor IDE](/ai-and-dev-tools/ide-plugins-overview/cursor-ide.md)
{% endcontent-ref %}

Once the plugin is installed, open the Aikido sidebar and go to **Aikido Cursor Plugin** to enable the Aikido MCP server.

[Learn more about Expansion Packs](/ai-and-dev-tools/ide-plugins-overview/features/aikido-expansion-packs.md)

### Via Cursor Marketplace

You can also install Aikido MCP directly from the [Cursor Marketplace](https://cursor.com/marketplace/aikido).

{% stepper %}
{% step %}
**Create an Aikido MCP token**

In Aikido, go to [Settings → Integrations → IDE → MCP](https://app.aikido.dev/settings/integrations/ide/mcp) and create a Personal Access Token.
{% endstep %}

{% step %}
**Add via Cursor Marketplace**

Open [Aikido on the Cursor Marketplace](https://cursor.com/marketplace/aikido) and click **Add to Cursor**.

When prompted, add your token as the `AIKIDO_API_KEY` environment variable.
{% endstep %}

{% step %}
**Add custom instructions**

Add an instruction to your `.cursorrules` file or Cursor custom instructions to ensure the agent uses the MCP server.

```
Scan any new or modified code with `aikido_full_scan` before finalizing changes. This security check is required.
```

{% endstep %}
{% endstepper %}

### Example Prompts

**Scanning code**

* "Use Aikido to scan this file for security issues"
* "Run an Aikido scan on my staged changes to check for secrets before I commit"
* "Scan the files I just edited with Aikido and link them to the `payments-api` repo"

**Reviewing issues by repo**

* "Show me all critical Aikido issues in `payments-api`"
* "List any leaked secrets in `frontend-web` from Aikido"
* "What open source vulnerabilities does Aikido see in `api-gateway`?"
* "Show SAST and IaC issues in `infra-core` from Aikido"

**Reviewing issues by cloud, VM, or container**

* "List all Aikido cloud issues in `prod-aws`"
* "Show malware findings on `web-server-01` from Aikido"
* "What end-of-life software is running in the `nginx-proxy` container per Aikido?"
* "Show me surface monitoring issues for `example.com` in Aikido"

**Combined workflows**

* "Use Aikido to scan my current changes, then show existing critical issues in the same repo"
* "Check this PR with Aikido and compare against open SAST issues in the repo"

### Manual installation

For any custom setup, refer to the [npm package page](https://www.npmjs.com/package/@aikidosec/mcp) for detailed manual installation instructions.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.aikido.dev/ai-and-dev-tools/aikido-mcp/cursor-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.