Skip to main content

raposa-mcp

An MCP server that gives your agent one honest tool: ask a human.

request_human_approval(action, context, risk) -> { approved: true|false, decided_by, ... }

approved is true only when a named person pressed Approve. A timeout, an expiry or a rejection all return approved: false — silence is not consent. Every decision is sealed in Raposa's hash-chained audit log, exportable for an auditor. EU-hosted, DPA available.

Install

{
  "mcpServers": {
    "raposa": {
      "command": "uvx",
      "args": ["raposa-mcp"],
      "env": { "RAPOSA_API_KEY": "<your key>" }
    }
  }
}

Claude Code: claude mcp add raposa -e RAPOSA_API_KEY=<your key> -- uvx raposa-mcp

Get a free sandbox key (100 approvals a month) at https://raposa.group/start/ — it arrives by email in a minute.

Tools

Tool What it does
request_human_approval(action, context, risk, requested_by?, wait_sec=600, expires_in_sec?) creates the request and waits for a human; returns approved
create_approval(action, context, risk, requested_by?, expires_in_sec?, webhook_url?) returns the id at once; decision arrives on the HMAC-signed webhook or via get_approval
get_approval(approval_id) reads one approval

risk is low | medium | high. The API key is read from RAPOSA_API_KEY only and never appears in tool inputs or outputs. Base URL override: RAPOSA_API_BASE (default https://dcescrypt.com/api).

Who approves

The people on your team who hold the approve button get a scoped console login and, if you give us their email, every request also reaches them as a mail with signed Approve / Reject links. Their name is recorded on the decision. Docs: https://raposa.group/docs/#approvers

Develop

pip install -e ".[test]" && pytest -q

MIT · DC ESCRYPT SL · contact@raposa.group

Download files

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

Source Distribution

raposa_mcp-0.1.1.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

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

raposa_mcp-0.1.1-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file raposa_mcp-0.1.1.tar.gz.

File metadata

  • Download URL: raposa_mcp-0.1.1.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for raposa_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3233991fab8dfff724cf92a210058fd1ce2c85a74880567958d0ccfb5ee850ae
MD5 0f6909dfbf393a8dc02c13e59baa0091
BLAKE2b-256 0b13e3b0ee6b81469664c0275d93d98e7eb2ec0166b528823c743244e8516304

See more details on using hashes here.

File details

Details for the file raposa_mcp-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: raposa_mcp-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 5.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.13

File hashes

Hashes for raposa_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 00f2130d7a68bf1d6a78cf0ca29a04060061b6518541cba4e18df6b400081f3e
MD5 229c7296d4e9d4335d9bd354f281abb8
BLAKE2b-256 13006885b352559da6b6cf0055b840a94c7e69486357ca10f74080491116abc9

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page