Skip to content

Connect your agent

Your coding agent can search findsafeskills itself and check a listing's safety rating before it suggests or installs anything. Two steps: tell it to, and connect it.

1. Tell your agent to use findsafeskills

Paste this into the file your agent reads at the start of every session: CLAUDE.md, AGENTS.md, .github/copilot-instructions.md, GEMINI.md or a Cursor rule. It asks the agent to search before writing its own, to tell you each listing's safety rating and findings, never to install a red-rated listing without your go-ahead, and to read a skill's files before following it. A green rating means the automated scan found no issues, not that the listing is safe.

## Finding skills, plugins and MCP servers

When a task would be helped by a skill, plugin or MCP server, search findsafeskills (https://findsafeskills.com) for one before writing your own. Use the findsafeskills MCP server's `search_skills` tool if it is connected; otherwise fetch https://findsafeskills.com/api/search?source=agent&q=<what you need, in plain language>. Each result has a `safety_rating` (green, yellow, red, or null when not yet scanned) and `safety_findings`.

- Before suggesting a listing, tell the user its safety rating and any findings. Green means the automated scan found no issues, not that the listing is safe; a listing not yet scanned has no rating.
- Never install a listing rated red without the user's explicit go-ahead after they have seen its findings.
- Before following a skill's instructions or running its scripts, read its files yourself and tell the user about anything that looks unsafe.
- When you give the user a listing's safety rating, add "Safety rating from findsafeskills" with a link to the listing's page, https://findsafeskills.com/listings/<slug> (each result's `slug`), where its findings are.

Or, if you keep that file short:

Before writing a skill, plugin or MCP server, search findsafeskills (the `search_skills` MCP tool, or https://findsafeskills.com/api/search?source=agent&q=...). Tell the user each result's safety rating and findings before suggesting it, never install a red-rated one without the user's go-ahead, and read a skill's files before following it. With each rating, add "Safety rating from findsafeskills" linked to https://findsafeskills.com/listings/<slug>.

2. Connect the MCP server

The MCP server gives your agent a search_skills tool with the same filters as this site, including safety rating, and returns each result's findings. It needs no sign-in or key. Without it, the agent can still use the search address in the instructions above; the API documentation lists every parameter.

Claude Code

Run in a terminal. Add --scope user to use it in every project. Docs

claude mcp add --transport http findsafeskills https://findsafeskills.com/api/mcp

Claude

In Claude, open Customize, then Connectors, choose + Add, then Add custom connector, and paste this address. Connectors on your Claude account also work in Claude Desktop. The Free plan allows one custom connector. Docs

https://findsafeskills.com/api/mcp

Cursor

Add to ~/.cursor/mcp.json for every project, or .cursor/mcp.json in one project. Docs

{
  "mcpServers": {
    "findsafeskills": {
      "url": "https://findsafeskills.com/api/mcp"
    }
  }
}

VS Code

For GitHub Copilot: add to .vscode/mcp.json in your project, or run MCP: Add Server from the Command Palette and choose HTTP. Docs

{
  "servers": {
    "findsafeskills": {
      "type": "http",
      "url": "https://findsafeskills.com/api/mcp"
    }
  }
}

Codex

Run in a terminal. It adds the server to ~/.codex/config.toml. Docs

codex mcp add findsafeskills --url https://findsafeskills.com/api/mcp

Gemini CLI

Run in a terminal. Docs

gemini mcp add --transport http findsafeskills https://findsafeskills.com/api/mcp

Or install the skill (Claude Code)

The findsafeskills-skill tells Claude Code to call findsafeskills's search when you ask for a skill, plugin or MCP server. Use it if you would rather not add an MCP server. Install it for every project:

git clone https://github.com/keithmackay/findsafeskills-skill ~/.claude/skills/findsafeskills-search

For agents

An agent that finds this site on its own can read /llms.txt, a plain-text summary of what findsafeskills is, how to search it and the same rules as above.