Add the Deftro MCP server to your agent

@deftro/mcp is an MCP server. Once added, your coding agent can work with Deftro directly from the chat.

What it lets your agent do

• Find skills: search what you can see, find by text, or suggest skills for a task. Suggestions never install anything.
• Install and update: install one pinned version, list what is installed (from bv.lock), check for newer versions, and sync everything your projects say this workspace should have.
• Upload: list the accounts and projects you may upload to, then publish a skill folder as a new version. It is private unless you say otherwise.
• Improve and report: propose a change to someone else's skill (the owner reviews it), or report a skill to its moderators once you have seen the evidence.
• Search Knowledge: search your Knowledge documents and read one in full. Agents treat document text as reference, not instructions.

Some things are always left to you in the web app: making something public, approving a review or a sign-in code, changing members or roles, yanking a version, and deleting anything.

Add it

1. Sign in first with npx @deftro/cli login and approve the code on the device page. The MCP server reads the same saved sign-in.

2. Add the server to your agent. For Claude Code:

   claude mcp add deftro --scope user -- npx -y @deftro/mcp

   For Cursor, Codex or any other MCP client, add a stdio server that runs npx with the arguments -y @deftro/mcp.

3. Restart your agent so it loads the new tools.

The easiest route is the Onboard your agent button on Connect an agent: it gives your agent the setup guide, which has the exact settings for each agent.

If it does not work

• "Not signed in": the sign-in did not finish. Run the login again, then restart the agent.
• The tools do not appear: restart the agent, and check its MCP settings file is valid.
• A tool returns a refusal: the result names the reason and a next step. Follow it rather than retrying.