# ForgingStack Mandate Check

> ForgingStack Mandate Check is a paid MCP server for security. Check an AI agent's mandate before it acts and get a hash-chained receipt. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Repository:** https://github.com/jdkabattles/forgingstack-mandate-check
- **MCP Registry name:** io.github.jdkabattles/forgingstack-mandate-check
- **Categories:** [security](https://ai-powered.com/categories/security), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The service answers a narrow question: is this agent allowed to do this action for this principal right now? A call checks four things in order: the mandate's agent matches the caller, its principal matches whom the agent acts for, its expiry parses and lies in the future, and the action appears in the mandate's allowed list. The result is pass or fail with a reason and a receipt linked into a hash chain.

It does not judge whether an action is wise, legal or safe, only whether it fits the mandate. This repository is just the public stdio client; the decision logic, receipt chain, key store and billing run on ForgingStack's private service, so you need an API key from the signup endpoint. Signup returns the key once with 100 starter credits, and humans can create capped, revocable sub-keys for each agent.

Each check costs one credit, even a failed decision, while a replay with the same idempotency key is free. The README warns that email verification is pending and credit-pack billing is not yet live.

## Features

- **Ordered mandate checks:** Verifies agent, principal, expiry and allowed action.
- **Receipts:** Each decision returns a hash-chained receipt.
- **Agent sub-keys:** Capped, revocable keys per agent.
- **Idempotent replays:** Repeating a call with the same key is free.
- **Credit metering:** One credit per check, failures included.
- **Starter credits:** 100 credits at signup.

## Good for

- Gating an autonomous agent's tool call on its mandate
- Keeping an auditable record of authorisation decisions
- Issuing limited keys to individual agents
- Testing delegation setups before production

## Install

### Claude Code (Terminal)

```sh
claude mcp add forgingstack-mandate-check --env FORGINGSTACK_API_KEY='<FORGINGSTACK_API_KEY>' -- uvx forgingstack-mandate-check
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "forgingstack-mandate-check": {
      "command": "uvx",
      "args": [
        "forgingstack-mandate-check"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "forgingstack-mandate-check": {
      "command": "uvx",
      "args": [
        "forgingstack-mandate-check"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "forgingstack-mandate-check": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "forgingstack-mandate-check"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "forgingstack-mandate-check": {
      "command": "uvx",
      "args": [
        "forgingstack-mandate-check"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "forgingstack-mandate-check": {
      "command": "uvx",
      "args": [
        "forgingstack-mandate-check"
      ],
      "env": {
        "FORGINGSTACK_API_KEY": "<FORGINGSTACK_API_KEY>"
      }
    }
  }
}
```

## Tools

- `check_mandate`: Check whether an action fits an agent's mandate
- `get_credits`: Show remaining credits
- `get_receipt`: Fetch a decision receipt

## FAQ

### What does it not check?

Whether an action is wise, legal or safe; only mandate fit.

### How do I get a key?

POST to /v1/signup with an email; the key is shown once.

### What does a check cost?

One credit, including failed decisions.

### Is purchasing live?

No. The README says credit-pack billing is not live in v1.

### Is ForgingStack Mandate Check free?

No. ForgingStack Mandate Check is a paid product.

### How do I add ForgingStack Mandate Check to Claude Code?

Run this command in your terminal: claude mcp add forgingstack-mandate-check --env FORGINGSTACK_API_KEY='<FORGINGSTACK_API_KEY>' -- uvx forgingstack-mandate-check

### What are the best alternatives to ForgingStack Mandate Check?

The closest alternatives to ForgingStack Mandate Check are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/forgingstack-mandate-check
