Skip to main content
Use the xysq MCP server in Cursor so your agent can authenticate to xysq and use memory tools (recall, retain, list, and related actions) from your editor.

​
Before You Connect

Sign in to your xysq account at app.xysq.ai.
xysq Login Screen

​
Step 1 - Generate Your API Key

  1. After logging in, click the Connect Agent button.
Connect Agent Button
  1. Select the Cursor tab.
Cursor Tab
  1. Click Generate API Key - your key will be created automatically.
Generate API Key

​
Step 2 - Copy the MCP Schema

Copy the generated MCP configuration schema: 
{
  "mcpServers": {
    "xysq": {
      "url": "https://api.xysq.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    },
    "xysq-legacy": {
      "url": "https://api.xysq.ai/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

​
Step 3 - Add to Cursor

  1. Open Cursor and navigate to mcp.json. You can find it at:
OSPath
Windows%USERPROFILE%\.cursor\mcp.json
macOS / Linux~/.cursor/mcp.json
  1. Paste the copied schema into mcp.json and save.
Paste schema into mcp.json

​
Step 4 - Connect from Cursor

  1. Open the Agent tab in Cursor.
  2. Type:
Connect to xysq agent
Cursor will initiate the connection automatically and you can start talking to it normally.
Connect to xysq agent in Cursor

​
Adding Memories

Once connected, you can ask the agent to remember, retain, or delete anything across future sessions: 
Remember that I prefer tabs over spaces in all projects.

Retain: My project deadline is June 15.

Delete the memory about my old API endpoint.
The agent will store and retrieve this from your xysq memory automatically.

​
Video Walkthrough

Video Thumbnail
(Full walkthrough video - link or embed coming soon)

​
Troubleshooting

ProblemFix
Server never connectsConfirm the URL and API key are copied exactly from the xysq dashboard. Check VPN or firewall rules for HTTPS to the MCP host.
Repeated auth promptsMake sure you finished the browser approval step. If the problem persists, remove and re-add the MCP server, then authenticate again.
Wrong workspace scopeUse the global ~/.cursor/mcp.json if you want xysq in every project. Use .cursor/mcp.json inside a repo only if you want to scope it to that project.
API key not workingRegenerate the key from the xysq dashboard and update the Authorization header in your mcp.json.
Schema paste breaks JSONValidate your mcp.json with a JSON validator - a missing comma or brace will silently prevent the server from loading.