{"slug": "cursor-mcp-setup-for-agent-skills", "title": "Cursor MCP setup for agent skills", "summary": "A developer documented how to connect SkillGild's hosted agent skills to Cursor by installing and signing in to the SkillGild CLI, then registering its absolute executable path as a local stdio server in Cursor's mcp.json. The guide covers project versus personal configuration precedence, an optional skill wrapper written to ~/.cursor/skills/, and a troubleshooting table for common MCP connection failures.", "body_md": "To connect SkillGild to Cursor, install and sign in to the SkillGild CLI, then register its absolute executable path in Cursor's `mcp.json` as a local stdio server. An optional skill wrapper in `~/.cursor/skills/` helps the agent recognize when to use a hosted workflow.\n\nCursor supports `.cursor/mcp.json` inside a project and `~/.cursor/mcp.json` for your personal setup. Project configuration takes precedence when the same server name appears in both. The [official Cursor MCP guide](https://prod.cursor.com/help/customization/mcp) explains configuration, tool approvals and logs.\n\nUse personal configuration if you want the connection available across projects. Use project configuration when the team needs the same server definition. Each teammate still signs in on their own machine; the configuration below contains no account credential.\n\nFollow [Install the CLI](https://skillgild.dev/docs/marketplace#1-install-the-cli). The current method uses Go 1.26 or later and the SkillGild source checkout. Then run:\n\n```\nskillgild login\nskillgild status\n```\n\nConfirm the browser's device code. The CLI stores its credential in the operating system's credential store, which the MCP process uses.\n\nOn macOS or Linux:\n\n```\ncommand -v skillgild\n```\n\nOn Windows, use `where.exe skillgild`. Use the resulting absolute path because an application launched outside the terminal may have a different `PATH`.\n\nOpen your chosen `mcp.json`. Merge the `skillgild` entry into its existing `mcpServers` object so other connections stay intact. Replace the placeholder command with your executable's absolute path:\n\n```\n{\n  \"mcpServers\": {\n    \"skillgild\": {\n      \"type\": \"stdio\",\n      \"command\": \"/absolute/path/to/skillgild\",\n      \"args\": [\"mcp\"]\n    }\n  }\n}\n```\n\nOn Windows, use forward slashes or escaped backslashes in JSON paths. Save the file and restart Cursor. Inspect the connection in its MCP controls; the current interface exposes MCPs through Customize. Follow your configured tool approval policy when starting a workflow.\n\n```\nskillgild install logo-design --agent cursor\n```\n\nThe CLI writes `~/.cursor/skills/logo-design/SKILL.md`. Cursor's [skills documentation](https://prod.cursor.com/docs/skills) explains local skill discovery. The wrapper identifies the workflow and how to call it; it requires the MCP connection for hosted tools.\n\n```\nUse the SkillGild Logo Design skill for a fictional cycling club called\nNorth Loop. Start with three geometric concepts. Check one-color use\nand small sizes, and show the proposed files before finalizing them.\n```\n\nFor a hybrid skill, the agent starts a session, receives its instructions, calls the declared hosted tools where needed and closes the session. For a prompt skill, it calls `skillgild_run_skill`. Inspect the [Logo Design listing](https://skillgild.dev/skills/logo-design) for current inputs and access.\n\n| Symptom | Check | \n|---|---|\n| Server executable cannot be found | Use the actual absolute path; test `skillgild status` in a terminal | \n| Configuration is not recognized | Validate the JSON, its `mcpServers` object and the correct project/user file | \n| The wrong server definition is used | Look for the same name in project and user configuration | \n| Server appears but hosted calls fail | Check the CLI's account connection, then inspect the returned error | \n| No tool is called for your task | Ask explicitly for the installed skill and review the available/enabled tools | \n\nFor server logs, open Cursor's Output panel and select MCP Logs. A local wrapper appearing in the skill list does not confirm that the server is connected. See [SkillGild's agent error handling](https://skillgild.dev/docs/quickstart-agents#handle-errors) for access and quota failures.\n\nThese configuration details were checked against Cursor documentation and the SkillGild CLI. An authenticated task still depends on your account approval and local environment.\n\nBrowse [hosted agent skills](https://skillgild.dev/skills), compare [skills and MCP](https://skillgild.dev/learn/agent-skills-vs-mcp), or follow the [Claude Code](https://skillgild.dev/learn/install-claude-code-skills) and [Codex CLI](https://skillgild.dev/learn/install-codex-skills) guides. The [Claude Code install guide](https://skillgild.dev/learn/install-claude-code-skills) connects these setup routes.\n\n*Originally published at [skillgild.dev](https://skillgild.dev/learn/cursor-mcp-setup).*", "url": "https://wpnews.pro/news/cursor-mcp-setup-for-agent-skills", "canonical_source": "https://dev.to/skillgild/cursor-mcp-setup-for-agent-skills-4kpk", "published_at": "2026-10-06 22:03:53+00:00", "updated_at": "2026-10-06 22:17:40.236589+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "developer-tools", "ai-tools"], "entities": ["Cursor", "SkillGild", "Model Context Protocol", "Go"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/cursor-mcp-setup-for-agent-skills", "markdown": "https://wpnews.pro/news/cursor-mcp-setup-for-agent-skills.md", "text": "https://wpnews.pro/news/cursor-mcp-setup-for-agent-skills.txt", "jsonld": "https://wpnews.pro/news/cursor-mcp-setup-for-agent-skills.jsonld"}}