Building Agents in Neo4j Aura ›Publishing Agents
Connect your agent to Cursor

Building Agents in Neo4j Aura

Introducing Neo4j Aura Agents

Building an Agent

Publishing Agents

Connect your agent to Cursor

In this challenge, you will enable external access for your agent, connect it to Cursor using the MCP endpoint, and test it with real prompts.

Enable external access

Changing access settings requires the Project Admin role.

  1. Select your agent and click the …​ menu, then select Configure.

    Agent menu showing Configure

  2. Under Access, select External.

  3. Enable the MCP server toggle.

    Access settings showing External selected with the Enable MCP server toggle visible

  4. Click Update agent to save your changes.

Your agent now has an MCP endpoint and the full tool list is visible in the configuration.

Complete agent configuration showing the Enable MCP server toggle on alongside the full list of agent tools

Connect to Cursor

  1. In the Agents list, open the …​ menu next to your agent and choose Copy MCP server endpoint.

    Agent menu showing Configure

  2. Open the Cursor menu from the top-left, then Settings…​, then Cursor Settings.

    Cursor menu with Settings and Cursor Settings highlighted

  3. In the left sidebar, select Tools & MCP.

  4. Under Installed MCP Servers, click + New MCP Server.

    Tools & MCP settings showing Installed MCP Servers and New MCP Server option

  5. A new file mcp.json will be created (typically at ~/.cursor/mcp.json) and opened in the editor. Add your agent’s MCP endpoint to the file. If you edit mcp.json directly, replace <your-mcp-url> with the endpoint from the agent menu:

    json
    {
  "mcpServers": {
    "neo4j-graphacademy-agent": {
      "url": "<your-mcp-url>",
      "transport": "http"
    }
  }
}

  6. Save and reload Cursor.

  7. Your agent appears in the Tools & MCP list with a Needs authentication status. Click Connect.

    Tools and MCP panel showing neo4j-graphacademy-agent with Needs authentication status and a Connect button

  8. Cursor asks permission to open the Aura MCP authentication website. Click Open.

    macOS dialog asking whether to open the aura-mcp.eu.auth0.com authorization URL in a browser

  9. The login page opens in your browser. Click Continue with Neo4j Aura.

    Login page for aura-mcp showing a Continue with Neo4j Aura button

  10. On the authorization screen, click Accept to grant Cursor access to your Aura MCP account.

    Authorize App screen showing Cursor requesting access to the aura-mcp account with Accept and Decline buttons

  11. Return to Cursor. Your agent is now connected and available as a tool.

For connecting other hosts such as Claude Desktop, see Aura Agent documentation.

Test your agent in Cursor

  1. Open a new Cursor chat in Agent mode.

  2. Address the agent by its MCP server name and ask a question that matches one of your Cypher Template tools.

  3. Ask a follow-up question that requires your Text2Cypher tool.

  4. Check that each response is accurate and that the reasoning panel shows the correct tool being selected.

Restart Cursor before testing

Restarting Cursor after adding the MCP endpoint is mandatory. If your agent is not working, a missed restart is likely the reason.

Summary

You connected your agent to Cursor using the MCP endpoint and tested it with real prompts. In the next lesson, you will see suggested next steps and mark the course as completed.

Chatbot

How can I help you today?

Data Model

Your data model will appear here.