> ## Documentation Index
> Fetch the complete documentation index at: https://java.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Coding with AI

AgentScope Java documentation supports the [`llms.txt` standard](https://llmstxt.org/), providing a machine-readable index optimized for Large Language Models. This allows you to use the documentation as context in your AI-powered development environment.

## What is llms.txt?

`llms.txt` is a standardized text file that acts as a map for LLMs, listing the most important documentation pages and their descriptions. This helps AI tools understand the structure of the documentation and retrieve relevant information.

AgentScope provides the following files:

| File               | Best For                                | URL                                           |
| ------------------ | --------------------------------------- | --------------------------------------------- |
| `v2/llms.txt`      | New projects using AgentScope Java 2.0  | `https://java.agentscope.io/v2/llms.txt`      |
| `v2/llms-full.txt` | Single-file AgentScope Java 2.0 context | `https://java.agentscope.io/v2/llms-full.txt` |
| `v1/llms.txt`      | Existing AgentScope Java 1.x projects   | `https://java.agentscope.io/v1/llms.txt`      |
| `v1/llms-full.txt` | Single-file AgentScope Java 1.x context | `https://java.agentscope.io/v1/llms-full.txt` |

## Development Tools

### Claude Code

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) can be configured to query the AgentScope documentation by adding an MCP server.

**Installation:**

```bash theme={null}
claude mcp add agentscope-docs -- uvx --from mcpdoc mcpdoc --urls AgentScopeJava:https://java.agentscope.io/v2/llms.txt
```

**Usage:**

Once installed, you can ask questions about AgentScope directly in Claude Code:

> How do I create a tool with AgentScope Java?

### Cursor

[Cursor](https://cursor.com/) IDE can be configured to access the AgentScope documentation in two ways.

**Method 1: Docs Feature (Recommended)**

1. Open **Cursor Settings** -> **Features** -> **Docs**
2. Click **+ Add new Doc**
3. Add URL: `https://java.agentscope.io/v2/llms-full.txt`

**Method 2: MCP Server**

1. Open **Cursor Settings** -> **Tools & MCP**
2. Click **New MCP Server** to edit `mcp.json`
3. Add the following configuration:

```json theme={null}
{
  "mcpServers": {
    "agentscope-docs": {
      "command": "uvx",
      "args": [
        "--from", "mcpdoc", "mcpdoc",
        "--urls", "AgentScopeJava:https://java.agentscope.io/v2/llms.txt"
      ]
    }
  }
}
```

**Usage:**

Once configured, you can prompt the coding agent:

> Use the AgentScope docs to build a ReActAgent with a weather tool.

### Windsurf

[Windsurf](https://codeium.com/windsurf) supports MCP servers for documentation access.

**Configuration:**

1. Open Windsurf Settings
2. Navigate to MCP configuration
3. Add the following server:

```json theme={null}
{
  "mcpServers": {
    "agentscope-docs": {
      "command": "uvx",
      "args": [
        "--from", "mcpdoc", "mcpdoc",
        "--urls", "AgentScopeJava:https://java.agentscope.io/v2/llms.txt"
      ]
    }
  }
}
```

### Other Tools

Any tool that supports the `llms.txt` standard or can ingest documentation from a URL can benefit from these files.

**For tools with Docs/Knowledge Base feature:**

* Add URL: `https://java.agentscope.io/v2/llms-full.txt`

**For tools with MCP support:**

* Use the MCP configuration template above with `mcpdoc`

**Prerequisites:**

MCP configurations require [`uv`](https://docs.astral.sh/uv/) to be installed, as they use `uvx` to run the documentation server.

For AgentScope Java 1.x projects, use the v1 URLs instead:

* `https://java.agentscope.io/v1/llms.txt`
* `https://java.agentscope.io/v1/llms-full.txt`