BETAekkOS is currently in beta. Please report all bugs to support@ekkos.dev
ekkOS_docs
Integration

Cursor Integration

Add persistent memory to Cursor with two integration options.

Choose Your Integration Method

ekkOS offers two ways to integrate with Cursor, each optimized for different workflows and cost preferences.

Gateway Proxy
Fully automatic, pay-per-token
MCP Tools
Manual control, Cursor subscription

Quick Comparison

FeatureGateway ProxyMCP Tools
Setup DifficultyMediumEasy
Pattern Injection Fully automaticManual calls
AI ProviderYour own API keyCursor subscription
CostPay OpenAI/Anthropic per token
ekkOS gateway free		Cursor Pro subscription
+ ekkOS usage tiers
Latency+50-100msOnly when calling tools

Method 1: Gateway Proxy (Automatic)

Recommended for: Power users with API credits

ekkOS sits between Cursor and your AI provider, automatically injecting patterns into every request. No manual tool calls needed.

✓ Pros
  • • Fully automatic pattern injection
  • • Patterns delivered with every request
  • • Access 500+ models via OpenRouter
  • • Context syncs across sessions
⚠ Considerations
  • • Requires own API key
  • • Pay per token to provider
  • • +50-100ms latency
  • • Not compatible with Cursor subscription models

1Get AI Provider API Key

Choose one provider:

OpenAI
GPT-4o, o1, o3-mini
Anthropic
Claude Opus/Sonnet 4.5
OpenRouter
500+ models, one key

2Configure Cursor Base URL

  1. 1.
    Open Cursor Settings (Cmd+,)
  2. 2.
    Go to Models tab
  3. 3.
    Paste your API key in OpenAI API Key field
  4. 4.
    Enable "Override OpenAI Base URL"
    Base URL: https://mcp.ekkos.dev/api/v1/gateway/openai
  5. 5.
    Click Verify

3Test Integration

Open Cursor Agent and ask a technical question. You should see patterns appear automatically:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧠 ekkOS Memory
✓ 3 patterns loaded
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Pattern Name
Solution: ...

💡 Pro Tip: Use OpenRouter

Get ONE API key from OpenRouter and access 500+ models:

  • • openai/gpt-4o - Latest GPT-4
  • • anthropic/claude-3.5-sonnet - Claude Sonnet
  • • x-ai/grok-4-fast-reasoning - Grok-4
  • • deepseek/deepseek-chat - Ultra-cheap 70B model

Method 2: MCP Tools (Manual Control)

Recommended for: Cursor Pro subscribers

ekkOS provides tools that the AI calls when needed. Uses your Cursor subscription, no separate AI costs.

✓ Pros
  • • Use Cursor subscription models
  • • No separate AI costs
  • • Control when to retrieve patterns
  • • Works with privacy mode
⚠ Considerations
  • • AI must manually call tools
  • • Depends on AI compliance
  • • No auto-injection
  • • Easier to forget to use memory

1Install ekkOS Connect Extension

  1. • Open Cursor Extensions (Cmd+Shift+X)
  2. • Search for "ekkOS Connect"
  3. • Install ekkostech.ekkos-connect
  4. • Click ekkOS icon in sidebar
  5. • Click "Connect Account" and authenticate

2MCP Configuration (Auto-Created)

The extension automatically creates ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ekkos-memory": {
      "url": "https://mcp.ekkos.dev/api/v1/mcp/sse",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer YOUR_EKKOS_API_KEY",
        "X-User-ID": "YOUR_USER_ID"
      }
    }
  }
}

3Restart Cursor

MCP servers only load on startup. Restart Cursor to activate ekkOS tools.

4Available Tools

ekkOS_Search

Search all 11 memory layers

ekkOS_Forge

Create new patterns

ekkOS_Context

Get full context

ekkOS_Track

Track pattern usage

Cost Comparison

Gateway Proxy

ekkOS Gateway: Free
Pattern injection included
AI Provider: Pay per token
• GPT-4o: ~$0.01 per 1K tokens
• DeepSeek: ~$0.0001 per 1K tokens
• Via your provider account

MCP Tools

Cursor Pro: $20/month
AI usage included
ekkOS: 5K calls free
• Developer: 5K/month free
• Builder: 250K for $39/month
• Team: 2M+ for $149/month

Which Method Should You Use?

Choose Gateway Proxy if:

  • You have API credits with OpenAI, Anthropic, or OpenRouter
  • You want fully automatic pattern injection (zero manual work)
  • You're willing to pay per-token for maximum integration
  • You want access to 500+ models via OpenRouter

Choose MCP Tools if:

  • You have Cursor Pro subscription ($20/month)
  • You want predictable costs (no per-token charges)
  • You need Cursor's privacy mode / zero data retention
  • You prefer manual control over when patterns are retrieved

💎 Hybrid Approach

Configure BOTH methods and toggle between them based on your task:

  • • Gateway proxy for active coding sessions (automatic patterns)
  • • MCP tools for quick questions (use subscription)
  • • Switch by toggling "Override Base URL" in Cursor settings

Troubleshooting

Gateway Proxy Issues

"Failed to verify API key"

  • • Verify your OpenAI/provider API key is valid and has credits
  • • Ensure base URL is exactly: https://mcp.ekkos.dev/api/v1/gateway/openai
  • • Check you're not using Cursor's built-in OpenAI integration (must override base URL)
  • • Test gateway health: curl https://mcp.ekkos.dev/api/v1/gateway/health

No patterns appearing in responses?

  • • Gateway only injects patterns for technical queries, not general chat
  • • Check you have patterns in your account: platform.ekkos.dev
  • • Verify ekkOS account is connected (different from AI provider key)
  • • Check Cursor's Network log for gateway requests

MCP Tools Issues

ekkOS tools not appearing?

  • • Check ~/.cursor/mcp.json exists and has ekkos-memory configured
  • • Restart Cursor (MCP servers only load on startup)
  • • Verify token matches your platform.ekkos.dev account
  • • Check Cursor Output panel → MCP Servers for connection errors

Patterns retrieved but not used?

MCP Tools require the AI to manually call tools. The AI must be instructed to use memory.

Solution: Switch to Gateway Proxy for automatic injection, or add an Always-Apply Cursor rule that reminds the AI to search memory before responding.

Recommended Setup Path

For Most Users:

  1. 1.
    Start with MCP Tools (easier setup, uses Cursor subscription)
  2. 2.
    Install ekkOS Connect extension and authenticate
  3. 3.
    Try manual tool calls for a few days
  4. 4.
    If you want automatic injection, upgrade to Gateway Proxy

For Power Users:

  1. 1.
    Start with Gateway Proxy (automatic, powerful)
  2. 2.
    Get OpenRouter API key (500+ models, often cheaper than direct providers)
  3. 3.
    Configure base URL override in Cursor settings
  4. 4.
    Enjoy fully automatic memory injection in every response

Next Steps

MCP Tools Reference

Complete tool documentation

View tools

Gateway Proxy Details

Deep dive into automatic injection

Learn more

Claude Code Integration

Use ekkOS with Claude Code

Configure

Need Help?

Platform Dashboard
platform.ekkos.dev
Support Email
support@ekkos.dev