Cursor Setup¶

Set up Cursor to generate idiomatic adk-fluent and Google ADK code.

1. Project rules¶

Cursor reads rules from .cursor/rules/ in your project root.

If you cloned the repo¶

The file is already generated at .cursor/rules/adk-fluent.mdc. Nothing to do.

This file is auto-generated by scripts/llms_generator.py from the ADK manifest. It updates automatically when the API changes via just docs or CI. Do not edit it manually.

If you installed via pip¶

Download the rules file into your project:

curl -L https://raw.githubusercontent.com/vamsiramakrishnan/adk-fluent/master/.cursor/rules/adk-fluent.mdc \
  --create-dirs -o .cursor/rules/adk-fluent.mdc

Custom docs (optional)¶

You can also add adk-fluent’s documentation site as a custom docs source:

Open Cursor Settings
Go to Features > Docs
Click Add new custom docs
Enter: https://vamsiramakrishnan.github.io/adk-fluent/

Then reference it in chat with @docs.

2. MCP server — live documentation access¶

MCP servers give Cursor on-demand access to the full adk-fluent documentation.

Option A: adk-fluent GitMCP (free)¶

Uses GitMCP to serve documentation directly from the GitHub repository.

npx -y @anthropic-ai/cursor-mcp-installer --transport http --url https://gitmcp.io/vamsiramakrishnan/adk-fluent adk-fluent

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adk-fluent": {
      "type": "sse",
      "url": "https://gitmcp.io/vamsiramakrishnan/adk-fluent"
    }
  }
}

Option B: Context7 MCP¶

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Usage — append use context7 to your prompt:

Build me a pipeline with a researcher and writer agent using adk-fluent. use context7

3. Verify the setup¶

After adding the rules file and MCP server, test it with a prompt like:

Create an adk-fluent agent that classifies customer support tickets
into categories, then routes them to specialized handler agents.
Use a FanOut for parallel processing and write results to state.

Cursor should:

Import from adk_fluent (not internal modules)
Use the fluent builder pattern with method chaining
Call .build() to produce native ADK objects
Use .writes() for state management