# UseGrant MCP Server

This is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) 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

- **list_providers**: List all providers
- **create_provider**: Create a new provider
- **get_provider**: Get a provider by ID
- **delete_provider**: Delete a provider
- **list_clients**: List all clients for a provider
- **create_client**: Create a new client for a provider
- **get_client**: Get client details by provider and client ID
- **delete_client**: Delete a client from a provider
- **list_domains**: List all domains for a provider
- **add_domain**: Add a domain to a provider
- **get_domain**: Get a domain by provider and domain ID
- **delete_domain**: Delete a domain from a provider
- **verify_domain**: Verify a domain for a provider
- **create_access_token**: Create a new access token for a client
- **list_tenants**: List all tenants
- **create_tenant**: Create a new tenant
- **get_tenant**: Get a tenant by ID
- **delete_tenant**: Delete a tenant
- **list_tenant_providers**: List all providers for a tenant
- **create_tenant_provider**: Create a new provider for a tenant
- **get_tenant_provider**: Get a provider for a tenant
- **delete_tenant_provider**: Delete a provider for a tenant
- **list_tenant_provider_policies**: List all policies for a tenant provider
- **create_tenant_provider_policy**: Create a new policy for a tenant provider
- **get_tenant_provider_policy**: Get a policy for a tenant provider
- **delete_tenant_provider_policy**: Delete a policy for a tenant provider
- **validate_access_token**: Validate an access token for a tenant

## Requirements

- Node.js 16 or higher
- A valid UseGrant API key. Refer [here](https://usegrant.dev/docs/authentication) for more details.

## Using with Claude desktop

Add the following config to your `claude_desktop_config` file:

```json
{
  "mcpServers": {
    "usegrant": {
      "command": "npx",
      "args": ["-y", "@usegrant/mcp-server"],
      "env": {
        "USEGRANT_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Testing

To test the MCP server, we can use [mcp inspector](https://github.com/modelcontextprotocol/inspector).

Copy the `.env.example` file to `.env` and set the `USEGRANT_API_KEY` environment variable.

```bash
npx @modelcontextprotocol/inspector -e USEGRANT_API_KEY=$USEGRANT_API_KEY npx tsx src/index.ts
```

To watch and build the project:

```bash
npm run dev
```

## License

This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.