Skip to main content

MCP server serving Rifteo security contexts to AI agents

Project description

Rifteo Context MCP

MCP server that gives AI agents live bug bounty program scope and Rifteo security contexts - load the right knowledge before starting an engagement.

License PyPI Issues PRs Welcome

Install

pip install rifteo-context-mcp

Or from source:

git clone https://github.com/rifteo/context-mcp
cd context-mcp
pip install -e .

Register with your agent

Auto-install (all detected agents)

rifteo-context install

Single agent

rifteo-context install --agent claude-code
rifteo-context install --agent cursor
rifteo-context install --agent gemini-cli

Project-level install

rifteo-context install --agent claude-code --project

See which agents are detected

rifteo-context agents

Supported agents

Agent Config location
claude-code ~/.claude.json (via claude mcp add)
cursor ~/.cursor/mcp.json
windsurf ~/.codeium/windsurf/mcp_config.json
gemini-cli ~/.gemini/settings.json
cline ~/.cline/data/settings/cline_mcp_settings.json
kiro ~/.kiro/settings/mcp.json
codex ~/.codex/config.toml
opencode ~/.config/opencode/opencode.json
amp ~/.config/amp/settings.json
continue ~/.continue/config.json

Manual install (Claude Code)

claude mcp add --scope user rifteo-contexts rifteo-context-mcp

MCP Tools

Contexts

Tool Description
list_contexts List all available contexts with one-line summaries
get_context Load a context by name (L1 overview or L2 full methodology)
search_contexts Search contexts by keyword

Once registered, ask your agent:

list all available security contexts
get the web-app-pentest context
load cloud-audit full methodology

Each context has two levels:

  • L1 - Overview and when to use (default)
  • L2 - Full detailed methodology

Bug Bounty Platforms

Tool Description
get_program_scope Fetch live scope for any bug bounty program (in-scope, out-of-scope, bounty eligibility, policy)
search_hacktivity Search publicly disclosed reports by vulnerability type, technology, or keyword

Connect your accounts:

HackerOne - get your token at https://hackerone.com/settings/api_token/edit

rifteo-context auth hackerone
# HackerOne username: yourname
# HackerOne API token: ****

Intigriti - get your token at https://app.intigriti.com/settings/api

rifteo-context auth intigriti
# Intigriti API token: ****

YesWeHack works without credentials. Immunefi has no public API.

Then ask your agent:

get the scope for hackerone program "security"
get the scope for yeswehack program "datadome-bot-bounty"
search hacktivity for GraphQL vulnerabilities

Platform support:

Platform Scope Auth required
hackerone Full scope + policy Yes - username + API token
bugcrowd Partial (public HTML only) No (full scope coming soon)
intigriti Full scope Yes - API token
yeswehack Full scope No
immunefi Direct link No

search_hacktivity searches HackerOne public disclosed reports and requires no credentials.

Manage connected platforms:

rifteo-context auth --list
rifteo-context auth --remove hackerone

Local development

Point the server at a local clone of the contexts repo:

RIFTEO_CONTEXTS_PATH=/path/to/contexts rifteo-context-mcp

Or set it in your agent's MCP config env:

{
  "command": "rifteo-context-mcp",
  "args": [],
  "env": {
    "RIFTEO_CONTEXTS_PATH": "/path/to/contexts"
  }
}

Without this env var the server fetches contexts live from the GitHub API.

Part of Rifteo

Part of the Rifteo open security toolkit.

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rifteo_context_mcp-1.0.2.tar.gz (13.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

rifteo_context_mcp-1.0.2-py3-none-any.whl (13.8 kB view details)

Uploaded Python 3

File details

Details for the file rifteo_context_mcp-1.0.2.tar.gz.

File metadata

  • Download URL: rifteo_context_mcp-1.0.2.tar.gz
  • Upload date:
  • Size: 13.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for rifteo_context_mcp-1.0.2.tar.gz
Algorithm Hash digest
SHA256 557aac09f7cb89ba257c50e0f8518e475eb0c13f2fbc4aeb543513285b3e8f0b
MD5 96b921cc5f8c891e30dcd5ad844669f4
BLAKE2b-256 4df7a65f765d358b37a6f029e9e2bbe3d20cc30b8f248b9bd4b63758054c0795

See more details on using hashes here.

Provenance

The following attestation bundles were made for rifteo_context_mcp-1.0.2.tar.gz:

Publisher: publish.yml on Rifteo/context-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file rifteo_context_mcp-1.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for rifteo_context_mcp-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b65221179e62d412db6d0b458d978914fe5903ae353441ac923bef1d2873c0ea
MD5 a3533f8a5b332840b17588e050ca1da2
BLAKE2b-256 d5c98a933789c4500214813b46168a66f9b3b977de049e27c8774767dc739dea

See more details on using hashes here.

Provenance

The following attestation bundles were made for rifteo_context_mcp-1.0.2-py3-none-any.whl:

Publisher: publish.yml on Rifteo/context-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page