使用说明
UseGrant MCP Server
This is a Model Context Protocol (MCP) server for interacting with the UseGrant API. It provides a set of tools for managing providers, clients, tenants, and access tokens through the UseGrant platform.
Tools
The tools are generated from the UseGrant OpenAPI spec when the server starts, one tool per API operation, so new API operations are available without updating the server.
Tools are named after the operation, for example:
- providers_list: List Providers
- providers_clients_create: Create Client
- providers_domains_verify: Verify Domain
- tenants_providers_policies_create: Create Tenant Provider Policy
- tenants_tokens_validate: Validate Token
Read-only operations are marked with readOnlyHint and delete operations with destructiveHint, so MCP clients can ask for confirmation before changing anything.
Requirements
- Node.js 22.19 or higher
- Network access to
sdk.usegrant.dev, the OpenAPI spec is loaded on start - A valid UseGrant API key. Refer here for more details.
Using with Claude desktop
Add the following config to your claude_desktop_config file:
{
"mcpServers": {
"usegrant": {
"command": "npx",
"args": ["-y", "@usegrant/mcp"],
"env": {
"USEGRANT_API_KEY": "your_api_key_here"
}
}
}
}
Testing
To test the MCP server, we can use mcp inspector.
Copy the .env.example file to .env and set the USEGRANT_API_KEY environment variable.
npx @modelcontextprotocol/inspector -e USEGRANT_API_KEY=$USEGRANT_API_KEY npx tsx src/index.ts
To watch and build the project:
npm run dev
License
This project is licensed under the MIT License. See the LICENSE file for details.
