All integrations
MCP Integration
Cursor + Archyl

Architecture-aware code suggestions in your favorite AI IDE

Integrate Archyl with Cursor via MCP and get code suggestions that understand your architecture. Cursor gains full context of your C4 model, ensuring AI-generated code respects system boundaries and established patterns.

Explore features
Cursor
Archyl
MCP Server· 191 MCP tools available
How it works

Three moving parts, zero glue code

01

Archyl's MCP server connects to Cursor

Cursor supports MCP servers natively. Once configured, Cursor's AI assistant can access all 191 Archyl tools to query and manage your architecture.

02

Cursor understands your architecture context

When you ask Cursor to generate or modify code, it can reference your C4 model to understand system boundaries, component responsibilities, and established relationships.

03

Code suggestions respect your architecture

Generated code follows your documented architecture patterns. Cursor knows which component owns which logic, what APIs exist, and how services communicate.

See it in action

What it looks like in practice

Cursor — checkout-service

handler.go

12 func (h *Handler) Capture(ctx context.Context) error {

13 order, err := h.orders.Get(ctx, id)

14 if err != nil { return err }

15 // idempotency: ADR-021

16 key := idempotency.From(ctx)

17 return h.payments.Capture(ctx, key, order)

18 }

Agentarchyl MCP

Is calling Payments from this handler allowed?

check_conformance · get_adr

Yes, through the Payments API client. Rule Layer boundary forbids direct DB access here.
ADR-021Payments API
Example: Architecture-aware code generation in Cursor
> @archyl What service handles user authentication?

The Authentication Service (container) in the
Platform system handles all auth flows. It has
3 components:
- JWT Validator (Go, chi router)
- OAuth2 Provider (Go, golang.org/x/oauth2)
- Session Manager (Go, Redis)

> Generate a middleware that validates JWT tokens
  following the existing auth patterns

Based on the Authentication Service architecture,
here's a middleware using your established patterns
with chi router and the existing JWT Validator
component...
What you get

Everything the integration unlocks

Architecture-Aware Code Generation

Cursor's AI uses your C4 model to generate code that respects component boundaries, existing API contracts, and established communication patterns.

Inline Architecture Context

Ask Cursor about any component while editing. Get descriptions, relationships, technology stacks, and ownership information without switching context.

Drift Detection in Editor

Query drift scores directly from Cursor to understand if the code you are editing has diverged from the documented architecture.

Component Documentation

Create and update architecture documentation from within Cursor. Add ADRs, update component descriptions, and link code to architecture elements.

Relationship Awareness

Cursor knows how your components communicate. When modifying an API, it can flag downstream components that might be affected.

Technology Stack Visibility

See what technologies are assigned to each component. Cursor uses this context to suggest code using the correct frameworks and libraries.

Setup

Up and running in minutes

  1. 1

    Get your Archyl API key

    Go to your Archyl profile settings and create an API key for the Cursor integration.

  2. 2

    Add Archyl MCP to Cursor

    Open Cursor settings, navigate to the MCP section, and add the Archyl MCP server configuration.

    snippet
    {
  "mcpServers": {
    "archyl": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic-ai/mcp-remote",
        "https://mcp.archyl.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <your-api-key>"
      }
    }
  }
}
  3. 3

    Start coding with architecture context

    Open any project in Cursor and start asking about your architecture. Cursor's AI now has full visibility into your C4 model.

Frequently asked questions

How does the Cursor integration differ from the Claude Code integration?

Both use the same Archyl MCP server with 191 tools. The difference is the host: Claude Code runs in your terminal, while Cursor runs in your IDE. The architecture data and capabilities are identical.

Does Cursor need to be on a specific plan for MCP support?

MCP support is available in Cursor. Check Cursor's documentation for the latest plan requirements. On the Archyl side, the MCP server works with all plans including the free Developer plan.

Can I use both Cursor and Claude Code with the same API key?

Yes. Your Archyl API key works with any MCP-compatible client. You can use the same key across Claude Code, Cursor, Windsurf, and any other tool that supports the Model Context Protocol.

Will the integration slow down Cursor?

No. MCP tool calls are made on-demand when the AI assistant needs architecture context. They do not run continuously in the background and add only milliseconds of latency per query.

More integrations

Claude Code

Architecture-aware AI coding, right from your terminal

GitHub

Keep architecture documentation in sync with your code

VS Code

Architecture context in your favorite editor

Free plan forever

Ready to connect Cursor?

Start on the free plan and plug Cursor into your architecture in minutes.

  • No credit card
  • Set up in five minutes
  • Viewers are always free
Book a demoRead the quickstart

Cursor MCP Server for Architecture Context

Connect Archyl's MCP server to Cursor IDE. Get architecture-aware code suggestions, check drift, and manage C4 components directly from your editor.

Architecture-aware code suggestions in your favorite AI IDE

Integrate Archyl with Cursor via MCP and get code suggestions that understand your architecture. Cursor gains full context of your C4 model, ensuring AI-generated code respects system boundaries and established patterns.

Cursor + Archyl: Architecture-Aware IDE | MCP Server Integration

Connect Archyl's MCP server to Cursor IDE. Get architecture-aware code suggestions, check drift, and manage C4 components directly from your editor.

Cursor architecture tool, Cursor MCP server, Cursor IDE architecture, Cursor C4 model, AI IDE architecture, Cursor integration

191 MCP tools available

Archyl's MCP server connects to Cursor

Cursor supports MCP servers natively. Once configured, Cursor's AI assistant can access all 191 Archyl tools to query and manage your architecture.

Cursor understands your architecture context

When you ask Cursor to generate or modify code, it can reference your C4 model to understand system boundaries, component responsibilities, and established relationships.

Code suggestions respect your architecture

Generated code follows your documented architecture patterns. Cursor knows which component owns which logic, what APIs exist, and how services communicate.

Architecture-Aware Code Generation

Cursor's AI uses your C4 model to generate code that respects component boundaries, existing API contracts, and established communication patterns.

Inline Architecture Context

Ask Cursor about any component while editing. Get descriptions, relationships, technology stacks, and ownership information without switching context.

Drift Detection in Editor

Query drift scores directly from Cursor to understand if the code you are editing has diverged from the documented architecture.

Component Documentation

Create and update architecture documentation from within Cursor. Add ADRs, update component descriptions, and link code to architecture elements.

Relationship Awareness

Cursor knows how your components communicate. When modifying an API, it can flag downstream components that might be affected.

Technology Stack Visibility

See what technologies are assigned to each component. Cursor uses this context to suggest code using the correct frameworks and libraries.

Get your Archyl API key

Go to your Archyl profile settings and create an API key for the Cursor integration.

Add Archyl MCP to Cursor

Open Cursor settings, navigate to the MCP section, and add the Archyl MCP server configuration.

{ "mcpServers": { "archyl": { "command": "npx", "args": [ "-y", "@anthropic-ai/mcp-remote", "https://mcp.archyl.com/mcp", "--header", "Authorization:${AUTH_HEADER}" ], "env": { "AUTH_HEADER": "Bearer <your-api-key>" } } } }

Start coding with architecture context

Open any project in Cursor and start asking about your architecture. Cursor's AI now has full visibility into your C4 model.

Example: Architecture-aware code generation in Cursor

How does the Cursor integration differ from the Claude Code integration?

Both use the same Archyl MCP server with 191 tools. The difference is the host: Claude Code runs in your terminal, while Cursor runs in your IDE. The architecture data and capabilities are identical.

Does Cursor need to be on a specific plan for MCP support?

MCP support is available in Cursor. Check Cursor's documentation for the latest plan requirements. On the Archyl side, the MCP server works with all plans including the free Developer plan.

Can I use both Cursor and Claude Code with the same API key?

Yes. Your Archyl API key works with any MCP-compatible client. You can use the same key across Claude Code, Cursor, Windsurf, and any other tool that supports the Model Context Protocol.

Will the integration slow down Cursor?

No. MCP tool calls are made on-demand when the AI assistant needs architecture context. They do not run continuously in the background and add only milliseconds of latency per query.