Connect your agent to BugRater
BugRater runs an MCP server. Point Claude Code, Codex, Cursor, claude.ai or any MCP client at it, and your agent can choose programs on pay, crowding and response data, and check scope before it sends a request. Public data needs no account.
- Public data
- https://bugrater.com/mcp
- As your account
- https://bugrater.com/mcp/account
Add it to your client
Pick your client. Signing in adds your project logs, cards and Attack Surface data to what the agent can use.
Claude Code
Public data, no account
claude mcp add --transport http bugrater https://bugrater.com/mcp
As your BugRater account
claude mcp add --transport http bugrater https://bugrater.com/mcp/account
Then run /mcp inside Claude Code, pick bugrater and sign in. Your browser opens BugRater to approve it.
Codex
Public data, no account
[mcp_servers.bugrater] url = "https://bugrater.com/mcp"
Add this to ~/.codex/config.toml.
As your BugRater account
[mcp_servers.bugrater] url = "https://bugrater.com/mcp" bearer_token_env_var = "BUGRATER_TOKEN"
Create a token in Settings, Agent access, and export it as BUGRATER_TOKEN before starting Codex.
Cursor
Public data, no account
{
"mcpServers": {
"bugrater": { "url": "https://bugrater.com/mcp" }
}
}
Add this to ~/.cursor/mcp.json, or .cursor/mcp.json in a project.
As your BugRater account
{
"mcpServers": {
"bugrater": { "url": "https://bugrater.com/mcp/account" }
}
}
Cursor shows a Needs login prompt next to the server. Click it to sign in.
VS Code
Public data, no account
{
"servers": {
"bugrater": { "type": "http", "url": "https://bugrater.com/mcp" }
}
}
Add this to .vscode/mcp.json, or run MCP: Add Server from the command palette.
As your BugRater account
{
"servers": {
"bugrater": { "type": "http", "url": "https://bugrater.com/mcp/account" }
}
}
VS Code asks you to sign in when the server starts.
claude.ai
Add a custom connector
https://bugrater.com/mcp/account
In Settings, Connectors, add a custom connector named BugRater with this URL. Claude opens BugRater to sign you in. For public data only, use https://bugrater.com/mcp and skip sign-in.
ChatGPT
Add a custom connector
https://bugrater.com/mcp/account
In developer mode, create a connector with this URL and choose OAuth. For public data only, use https://bugrater.com/mcp with no authentication.
Any MCP client
Streamable HTTP endpoint
https://bugrater.com/mcp
Supports MCP versions 2025-03-26 through 2026-07-28. No account is needed. For your account, use https://bugrater.com/mcp/account, which signs in with OAuth (dynamic client registration, PKCE), or send a token from Settings as Authorization: Bearer bra_live_… to either URL.
Prefer a token to signing in? Create one in Settings, Agent access and send it as
Authorization: Bearer bra_live_… to either URL.
Example scope check
This is check_scope answering for
TransUnion LLC
on HackerOne, computed just now from the scope BugRater imported on Oct 22, 2026.
Only in scope means the agent can go ahead. Anything else should go to a person to check against the policy.
| Target | Verdict | Because of |
|---|---|---|
| api.chile.transunion.com | in scope | *.chile.transunion.com |
| chile.transunion.com | unclear | *.chile.transunion.com |
| *.security.neustar | out of scope | *.security.neustar |
| http://customertest.drivershistory.com/dr3/api/dr30/getcombined | out of scope | http://customertest.drivershistory.com/dr3/api/dr30/getcombined |
A wildcard covers subdomains but may not cover the apex domain, so the apex comes back unclear. An out-of-scope entry wins over a broader in-scope one. Contract addresses match the explorer links platforms list them as.
What your agent can ask
There are 27 tools. Answers carry their sources and dates, and say when a figure rests on too few reports to
trust. Three prompts come with them: choose_target, program_dossier and
pre_test_check. When you're signed in, each of your cards also appears as a prompt.
Choose where to hunt
- find_programs
- Search every program by name, platform, type, whether it pays and whether it is open.
- hunting_brief
- Programs that launched, started paying, got busier or went quiet in the last 7, 14 or 30 days.
- crowding
- Reports per in-scope asset over the last 90 days, showing which assets are crowded and which are quiet.
- get_program
- One program in full: payouts by severity with sample sizes, response targets, intake, barriers, the researcher grade, and why reports get closed.
- get_reviews
- Reviews from researchers who worked on the program, with their ratings.
- program_activity
- Recent public accepted findings: severity, target, award.
Stay in scope
- check_scope
- Up to 50 hosts, URLs, IPs, app ids or contract addresses, one verdict each.
- get_scope
- The structured scope as the platform publishes it, with bounty eligibility and instructions.
Researchers, CVEs and badges
- get_researcher
- A researcher's BugScore, HackerOne standing and vendor CVE credits.
- lookup_cve
- Who vendor advisories credit for a CVE, and whether it belongs to a given program's vendor.
- verify_badge
- Whether a BugBadge attached to a report is valid, and who it belongs to.
With your account
- whoami
- Which account the agent is acting for, its limits and balance.
- read_project_log
- Your collab projects and their research logs.
- log_research
- Append an attributed entry to a project log. Encrypted projects take ciphertext only.
- get_card
- Load one of your cards as working instructions.
- attack_surface
- Subdomains, probes and signals for a program, billed to your Attack Surface balance.
Access and limits
- Without an account
- You can use every public tool at 40 calls a minute per address, with no sign-up.
- Signed in
- 120 calls a minute, and access to your project logs, cards and Attack Surface data. Attack Surface calls are billed to your existing API balance at the published prices. Everything else is free.
- What a connection can't do
- Change your settings, see your email or password, delete anything, or reach the admin API. Revoke a token or a connected app in Settings, Agent access and it stops working on the next call.
- What BugRater sees
- BugRater sees only the questions your agent asks, and never touches your targets. We log which tool was called and when, but not the arguments, so a scope check does not tell us what you are about to test. See the privacy policy and terms.
- Where the data comes from
- Reviews are BugRater's. Scope, payouts, intake and response targets are the platforms' own published figures, copied on the date each answer gives. The program's policy page is the authority.
Skill file and docs
- A skill file
- Install it in Claude Code, or any client that reads SKILL.md, so the agent knows when to use BugRater and to check scope first.
-
curl -fsSL https://bugrater.com/agents/skill.md --create-dirs -o ~/.claude/skills/bugrater/SKILL.md
- For crawlers and tool builders
- The developer docs cover the REST API, x402 pay-per-call and sign-in, and are also
published as /openapi.json, /llms.txt and
/llms-full.txt. Every program page also has a Markdown version. Add
.mdto its URL, or requesttext/markdown.