# grantex

Authorization and delegation layer for AI agents that issues scoped, time-limited tokens with audit logging.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 33
- Author: mishrasanjeev
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mishrasanjeev/grantex
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/grantex

## What it does

Grantex acts as a dedicated authorization protocol, bringing an OAuth 2.0 design to autonomous assistants. The MCP server connects models to this verification mechanism, linking an agent to a human or organizational principal. Through this connection, agents receive verifiable identities and explicit permissions for actions.

Standard MCP configurations handle tool connectivity, whereas Grantex enforces boundary checks on whether an agent may invoke a given tool. The protocol manages multi-agent handoffs and service-side validation. Each issued grant remains revocable and tracked.

Running `@grantex/mcp` strictly requires a configured `GRANTEX_API_KEY` environment variable. While the client SDKs and MCP packages follow the permissive Apache 2.0 terms, running the core Grantex platform inside a company requires written approval from Orchestrum Technologies LLP under its source-available license.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `GRANTEX_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add grantex -e GRANTEX_API_KEY=<GRANTEX_API_KEY> -- npx -y @grantex/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add grantex --env GRANTEX_API_KEY=<GRANTEX_API_KEY> -- npx -y @grantex/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "grantex": {
            "command": "npx",
            "args": [
                "-y",
                "@grantex/mcp"
            ],
            "env": {
                "GRANTEX_API_KEY": "<GRANTEX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "grantex": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@grantex/mcp"
            ],
            "env": {
                "GRANTEX_API_KEY": "<GRANTEX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e GRANTEX_API_KEY=<GRANTEX_API_KEY> grantex npx -y @grantex/mcp
```
Replace <…> with your own values

## When to use it
- Restrict autonomous agent operations using scoped, expiring grants
- Verify whether an assistant holds authority to act for a principal
- Maintain clear audit trails across multi-agent task chains
- Revoke tool permissions without invalidating primary user credentials

## Example prompts
- Verify the delegation token before calling the merchant API
- Issue a scoped temporary grant for the subordinate purchasing agent
- Check the authorization audit log for the current task sequence

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12109
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/en/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP server · ★ 7658
- [jshookmcp](https://affpapa.org/en/nevibecode/mcp/jshookmcp.md) — MCP server · ★ 2061
- [OpenOSINT](https://affpapa.org/en/nevibecode/mcp/openosint.md) — MCP server · ★ 1802

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md