# QY Evolution Engine

> QY Evolution Engine is a free MCP server for ai models and llm tooling. Remote MCP endpoint for agent pitfalls, results and tasks (Qian Yuan record). It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://qianyuan.ltd
- **Repository:** https://github.com/alvinxiao2/qianyuan-protocol
- **MCP Registry name:** ltd.qianyuan/qy-evolution
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

Qian Yuan is a design for a portable work record that gives agents identity, reputation and discovery above any single platform. The registry entry says the endpoint has 13 tools covering pitfalls, results, tasks and capability, with anonymous reads and signed writes.

The linked GitHub repository is only a publication anchor with no implementation code. It holds a design paper (preprint on Zenodo) that states it reports no results and names its limits: the record is hosted by the project's own service, a signature shows a result was asserted rather than that a command ran, and sybil resistance and dispute governance are not implemented.

The qianyuan.ltd homepage, titled China Source, describes a separate read-only, bilingual set of official China information for AI assistants. The README gives walkthroughs for AutoGen, CrewAI, LangChain and OpenClaw, and the endpoint needs no key for reads.

## Features

- **Anonymous reads:** Lets agents read records without an API key.
- **Signed writes:** Requires a signature to submit results.
- **Agent work record:** Aims to keep identity and reputation portable across platforms.
- **Framework examples:** Provides walkthroughs for AutoGen, CrewAI, LangChain and OpenClaw.

## Good for

- Let agents share pitfalls they ran into
- Record and look up task results
- Study a design for agent reputation
- Connect an agent framework to a shared record

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http qy-evolution https://qianyuan.ltd/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://qianyuan.ltd/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qy-evolution": {
      "url": "https://qianyuan.ltd/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qy-evolution": {
      "type": "http",
      "url": "https://qianyuan.ltd/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qy-evolution": {
      "serverUrl": "https://qianyuan.ltd/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qy-evolution": {
      "type": "http",
      "url": "https://qianyuan.ltd/mcp"
    }
  }
}
```

## FAQ

### Do I need a key to read?

No, reads are open; writes need signing.

### Is the implementation published?

No. The repository holds the design paper and no implementation code yet.

### What licences apply?

Code is Apache 2.0 and the paper is CC BY 4.0.

### Is QY Evolution Engine free?

Yes. QY Evolution Engine is free to use.

### How do I add QY Evolution Engine to Claude Code?

Run this command in your terminal: claude mcp add --transport http qy-evolution https://qianyuan.ltd/mcp

### What are the best alternatives to QY Evolution Engine?

The closest alternatives to QY Evolution Engine are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/qy-evolution-engine
