Give Cursor, Windsurf, Cline, and other AI-powered coding agents the shared long term memory so that they can perform the task well together with the relevant context with this Model Context Protocol server.

When Cursor has the knowledge about the codebase; experiences in the past about how it has solved the project's issues with human it's way better and cost effective than re-entering the reasoning loop again.

See quickstart instructions →

How it works

1. Open your IDE's chat (e.g. agent mode in Cursor).
2. Let the Agent know how they're going to use the external memories (cursor rules, etc.)
3. Cursor will retrieve and store the relevant memories while performing the tasks

Getting Started

Many code editors and other AI clients use a configuration file to manage MCP servers.

The byterover-mcp server can be configured by adding the following to your configuration file.

> NOTE: You can either provide your Byterover API key and user ID in the configuration or start the server without credentials and configure it later via the API endpoints. Instructions on how to create a Byterover API access token can be found here.

$3

``json
{
"mcpServers": {
"Byterover Memory MCP": {
"command": "npx",
"args": [
"-y",
"byterover-mcp",
"--byterover-public-api-key=YOUR-PUBLIC-KEY",
"--user-id=YOUR-NAME",
"--llm-key-name=YOUR-LLM-KEY-NAME",
"--model=YOUR-LLM-MODEL-NAME"
]
}
}
}
`

$3

`json
{
"mcpServers": {
"Byterover Memory MCP": {
"command": "cmd",
"args": [
"/c",
"npx",
"-y",
"byterover-mcp",
"--byterover-public-api-key=YOUR-PUBLIC-KEY",
"--user-id=YOUR-NAME",
"--llm-key-name=YOUR-LLM-KEY-NAME",
"--model=YOUR-LLM-MODEL-NAME"
]
}
}
}
`

If you need more information about Byterover see the Byterover docs.

Running Without Initial Credentials

You can now start the Byterover MCP server without providing the API key and user ID upfront:

`bash


Install the package

The server will start with limited functionality and provide instructions on how to configure it. By default, the server runs on port 3333, but you can specify a custom port using the --port option as shown above.

$3

Once the server is running, you can configure it using the following API endpoints:

#### Update Credentials

`bash
curl -X POST http://localhost:3333/config \
-H "Content-Type: application/json" \
-d '{"byteroverPublicApiKey":"YOUR_API_KEY","userId":"YOUR_USER_ID"}'
`

#### Check Configuration Status

`bash
curl http://localhost:3333/config/status
`

$3

If you're running the server directly with Node.js:

`bash


Build the project

Requirements

- Node.js version 20 or higher