> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grantex.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Use Grantex from Claude Desktop, Cursor, or Windsurf via the Model Context Protocol.

## Install

```bash theme={null}
npm install -g @grantex/mcp
```

## Configuration

Add to your MCP config (Claude Desktop, Cursor, or Windsurf):

```json theme={null}
{
  "mcpServers": {
    "grantex": {
      "command": "grantex-mcp",
      "env": {
        "GRANTEX_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Environment Variables

| Variable           | Required | Description                                                |
| ------------------ | -------- | ---------------------------------------------------------- |
| `GRANTEX_API_KEY`  | Yes      | Your Grantex API key                                       |
| `GRANTEX_BASE_URL` | No       | Override API base URL (default: `https://api.grantex.dev`) |

## Available Tools

The MCP server exposes 17 tools:

| Tool                               | Description                                                   |
| ---------------------------------- | ------------------------------------------------------------- |
| `grantex_agent_register`           | Register a new AI agent                                       |
| `grantex_agent_list`               | List all registered agents                                    |
| `grantex_agent_get`                | Get details for a specific agent                              |
| `grantex_agent_update`             | Update an existing agent                                      |
| `grantex_agent_delete`             | Delete an agent                                               |
| `grantex_authorize`                | Start an authorization flow                                   |
| `grantex_token_exchange`           | Exchange authorization code for grant token                   |
| `grantex_token_verify`             | Verify a grant token                                          |
| `grantex_token_revoke`             | Revoke a grant token                                          |
| `grantex_token_refresh`            | Refresh a grant token (single-use rotation)                   |
| `grantex_grant_list`               | List grants with filters                                      |
| `grantex_grant_get`                | Get grant details                                             |
| `grantex_grant_revoke`             | Revoke a grant                                                |
| `grantex_grant_delegate`           | Delegate a grant to a sub-agent                               |
| `grantex_audit_log`                | Log an audit entry                                            |
| `grantex_audit_list`               | List audit entries                                            |
| `grantex_principal_session_create` | Create a principal session for end-user permission management |

## Usage

Once configured, you can interact with Grantex through natural language in your MCP-compatible client:

* "Register a new agent called travel-booker with calendar:read and payments:initiate scopes"
* "List all my active grants"
* "Revoke grant grnt\_01XYZ..."
* "Show the audit log for agent ag\_01ABC..."