Cursor Integration

Connect Hubify Labs to Cursor via the MCP server. This lets Cursor's AI access your lab's experiments, papers, and knowledge base directly within your IDE.

Setup

Install the MCP server

npm install -g @hubify/mcp-server

Add to Cursor MCP config

Create or edit .cursor/mcp.json in your project root:

{
"mcpServers": {
  "hubify": {
    "command": "hubify-mcp",
    "args": ["--lab", "bigbounce"],
    "env": {
      "HUBIFY_API_KEY": "hfy_key_abc123..."
    }
  }
}
}

Restart Cursor

Restart Cursor to pick up the new MCP configuration. The Hubify tools will appear in Cursor's tool palette.

Usage

In Cursor Chat

Open Cursor's chat (Cmd+L) and ask questions about your lab:

What experiments are currently running in my Hubify lab?

Cursor will call the Hubify MCP tools and display results inline.

In Composer

When using Cursor Composer for multi-file edits, the Hubify context is available:

Write a Python analysis script for the MCMC chain from experiment EXP-054.
Use the actual parameter names and column layout from the experiment outputs.

Cursor will fetch the experiment metadata via MCP and generate code that matches your actual data.

Inline Context

Reference Hubify resources with @ mentions:

@hubify://experiments/exp_054 Write a summary of these results

Common Workflows

Workflow	Example
Write analysis code	"Write a script to plot posteriors from EXP-054"
Check experiment status	"Is my MCMC chain done yet?"
Draft paper sections	"Draft the methods section based on our experiment configs"
Search knowledge	"What does our wiki say about the Hubble tension?"
Monitor compute	"How much GPU budget is remaining?"

Tips

• Use project-scoped MCP config (.cursor/mcp.json) so different projects connect to different labs
• The MCP server caches frequently accessed data to reduce latency
• Combine Hubify MCP with other MCP servers (e.g., GitHub, filesystem) for a complete research IDE experience

Troubleshooting

<AccordionGroup>

Tools not appearing in Cursor

Ensure the .cursor/mcp.json file is in your project root (not a subdirectory). Restart Cursor after adding it.

Authentication errors

Verify your API key is valid:

hubify auth status

Slow tool responses

The MCP server makes API calls to api.hubify.com. Check your network connection. Use --verbose for debugging:

{ "args": ["--lab", "bigbounce", "--verbose"] }

</AccordionGroup>