If you haven't already:
cd starter-kit
./install.shVerify it's running:
curl http://localhost:8080/health
curl http://localhost:8082/health # MCP gatewayCursor supports MCP servers through its settings. There are two ways to configure it:
Create .cursor/mcp.json in your project root:
{
"mcpServers": {
"AgentOS": {
"command": "bash",
"args": ["/absolute/path/to/AgentOS/scripts/mcp-stdio-bridge.sh"]
}
}
}Add to your Cursor settings (~/.cursor/mcp.json):
{
"mcpServers": {
"AgentOS": {
"command": "bash",
"args": ["/absolute/path/to/AgentOS/scripts/mcp-stdio-bridge.sh"]
}
}
}The path must be absolute. Find it with:
echo "$(cd AgentOS && pwd)/scripts/mcp-stdio-bridge.sh"- Open Cursor
- Open the project with the MCP config
- Open Cursor Settings > MCP
- You should see
AgentOSlisted and connected
If it shows as disconnected, click the refresh button or restart Cursor.
In Cursor's AI chat or inline edit, try:
Should be allowed (read):
List files in the src directory
Should trigger review (write):
Create a new branch and open a PR with these changes
Should be blocked (destructive):
Run rm -rf on the build directory
- Cursor looks for
.cursor/mcp.json(note the.cursordirectory, not.mcp.json) - Restart Cursor after creating the config file
- Check that the JSON is valid (no trailing commas)
- Ensure
bashis available at the default path - Ensure the bridge script path is absolute
- Ensure
scripts/mcp-stdio-bridge.shis executable:chmod +x scripts/mcp-stdio-bridge.sh
- Cursor may use its own built-in tools alongside MCP tools
- AgentOS only governs actions that pass through the MCP bridge
- For full coverage, configure Cursor to prefer MCP tools over built-in ones
When AgentOS returns a review decision, the agent will receive a response indicating the action is pending approval. Check and manage approvals:
# List pending
curl -s http://localhost:8081/admin/v1/approvals -H "X-API-Key: starter-key-001" | jq .
# Approve
curl -s -X POST http://localhost:8081/admin/v1/approvals/{id}/approve \
-H "Content-Type: application/json" \
-H "X-API-Key: starter-key-001" \
-d '{"reviewer":"your-name","comment":"Approved"}'