mcpField
F
ForgingStack Quorum

ForgingStack Quorum

Local
github.com/jdkabattlesAI & Agents0Updated 5d ago
Repository

About ForgingStack Quorum

ForgingStack Quorum is a public MCP client for a private approval service, aimed at agents whose proposed actions require human authorization. It collects a configurable number of email approvals before issuing a hash-chained receipt.

Key features

  1. 01Create proposals with named approvers
  2. 02Set required approvals and expiry
  3. 03Approve through one-time email links
  4. 04Reject pending proposals
  5. 05Retrieve proposals, credits, and receipts

Use cases

  1. 01Require approval before deploying a build
  2. 02Record a receipt after an approval quorum

MCP support

Runs as an MCP server over stdio and wraps the private service. It provides tools to create proposals and retrieve proposal status, credits, and receipts.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "jdkabattles-forgingstack-quorum": {
      "command": "uvx",
      "args": [
        "forgingstack-quorum"
      ],
      "env": {
        "FORGINGSTACK_API_BASE": "<FORGINGSTACK_API_BASE>",
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
Run commanduvx forgingstack-quorum
Environment variables to set
FORGINGSTACK_API_BASEQuorum API base URL. Live default.
FORGINGSTACK_API_KEYSecretAPI key for Quorum. Sign up via POST /v1/signup (key shown once).

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiforgingstack-quorum0.1.0

Tools

4

Saved tool list · updated 5d ago

ParameterTypeRequiredDescription
actionstringYesThe action to approve, non-empty, at most 500 characters.
approversarrayYesEmail addresses of the approvers (at least as many as required_approvals).
expires_atstringYesProposal expiry, ISO 8601, must be in the future.
mandate_refstringNoOptional reference to a mandate (at most 500 characters).
required_approvalsintegerYesHow many approvals are needed for quorum (1 or more).

Details

From the project README

ForgingStack Quorum

Before an agent acts alone, get the quorum. One proposal, N approvals, one receipt.

mcp-name: io.github.jdkabattles/forgingstack-quorum

This is the public client for Quorum. The service itself — the approval flow, the receipt chain, the key store, and billing — runs on ForgingStack's private service and is not in this repo. Copying this repo does not give you the service: you still need an API key and credits, from signup below.

Live API: https://forgingstack-quorum.jkbattles.workers.dev

How it works

  1. You propose an action, name the approvers, and set how many approvals are needed (N) and when the proposal expires.
  2. Each approver gets a one-time emailed link. Approvals are free.
  3. At quorum the proposal is approved and a hash-chained receipt is issued. If it expires first, it expires — no receipt, and the proposal cannot be approved afterwards.
  4. You can also reject a pending proposal yourself.

What it does not do: decide if an action is wise, legal, or safe. Quorum only — the approvers decide the rest.

Signup

curl -X POST https://forgingstack-quorum.jkbattles.workers.dev/v1/signup \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

Returns an API key once and 100 starter credits. Save the key immediately — it is stored only as a hash and cannot be shown again. Click the verification link in the signup email before the key can create proposals (if the mail does not arrive, check spam, or POST /v1/verify/resend).

Create a proposal

curl -X POST https://forgingstack-quorum.jkbattles.workers.dev/v1/proposals \
  -H "X-API-Key: YOUR_PRIMARY_KEY" -H "Content-Type: application/json" \
  -d '{"action":"deploy the new build","approvers":["[email protected]","[email protected]"],"required_approvals":2,"expires_at":"2027-01-01T00:00:00Z"}'

Returns the proposal (201) with its approval state and which approval emails were sent. Read it back with GET /v1/proposals/{id}, list yours with GET /v1/proposals, reject a pending one with POST /v1/proposals/{id}/reject. Approvers approve by clicking the link in their email — each link works once. The receipt, once issued, is at GET /v1/receipts/{id}.

Use it (MCP, stdio)

Set the key, then run the MCP server in this repo:

export FORGINGSTACK_API_KEY="your-key-here"
python -m app.mcp_server

Tools: create_proposal, get_proposal, get_credits, get_receipt. See SKILL.md for when to use it and when not to.

Price

1 credit per proposal. Approvals are free. 100 starter credits on signup. $10 for 1,000 credits via POST /v1/billing/checkout (Payment Link). Credits land after payment is verified — usually within the hour.

Files in this repo

  • app/mcp_server.py — MCP wrapper client (stdio, stdlib only)
  • SKILL.md — when to use it, how to read the result
  • agent-card.json — A2A-style discovery card
  • server.json — MCP Registry metadata
  • pyproject.toml — package metadata for the MCP client
  • llms.txt — short index for language-model readers

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.