Metadata-Version: 2.4
Name: inferexai-mcp
Version: 0.1.0
Summary: MCP server for InferexAI — manage your LLM gateway account from Claude Desktop, Claude Code, or any MCP-compatible agent
Project-URL: Homepage, https://inferexai.cloudvoice.in
Project-URL: Documentation, https://inferexdocs.cloudvoice.in
Project-URL: Repository, https://github.com/covideoin/inferexai
Author-email: Enterux Solutions Pvt Ltd <support@inferexai.cloudvoice.in>
License: MIT
Keywords: ai,claude,inferexai,llm,mcp,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# inferexai-mcp

Official MCP (Model Context Protocol) server for [InferexAI](https://inferexai.cloudvoice.in) — lets Claude Desktop, Claude Code, or any MCP-compatible AI agent manage your LLM gateway account conversationally.

## Installation

```bash
pip install inferexai-mcp
```

## Quick start

```bash
INFEREXAI_API_KEY=sk-live-your-key-here inferexai-mcp
```

## Claude Desktop setup

Add to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "inferexai": {
      "command": "inferexai-mcp",
      "env": {
        "INFEREXAI_API_KEY": "sk-live-your-key-here"
      }
    }
  }
}
```

Restart Claude Desktop. You can now ask Claude things like:

> "What's my InferexAI wallet balance?"
> "Create a new API key called 'staging' that expires in 3 months"
> "Show me my usage for the last 7 days"
> "Invite dev@acme.com to my organisation"

## Claude Code setup

```bash
claude mcp add inferexai -e INFEREXAI_API_KEY=sk-live-your-key-here -- inferexai-mcp
```

## Available tools

| Tool | Description |
|------|-------------|
| `wallet_balance` | Get current wallet balance in INR |
| `list_keys` | List all API keys with status, scopes, limits |
| `create_key` | Create a new API key (name, expiry, scopes) |
| `revoke_key` | Permanently revoke a key by ID |
| `query_usage` | List recent usage events with filters |
| `usage_summary` | Aggregated token, cost, error stats |
| `get_account` | Account details and KYC status |
| `set_low_balance_alert` | Set wallet alert threshold in ₹ |
| `get_org` | Organisation info and wallet |
| `create_org` | Create a new organisation |
| `list_org_members` | List org members with roles |
| `invite_org_member` | Invite a member by email |
| `remove_org_member` | Remove a member by user ID |

## Environment variables

| Variable | Required | Default |
|----------|----------|---------|
| `INFEREXAI_API_KEY` | Yes | — |
| `INFEREXAI_BASE_URL` | No | `https://inferexapi.cloudvoice.in` |

## Requirements

- Python 3.10+
- `mcp >= 1.0.0`
- `httpx >= 0.24.0`

## Links

- [Dashboard](https://inferexai.cloudvoice.in)
- [Documentation](https://inferexdocs.cloudvoice.in)
- [Python SDK](https://pypi.org/project/inferexai/)
- [npm SDK](https://www.npmjs.com/package/inferexai)

## License

MIT © [Enterux Solutions Pvt Ltd](https://enterux.com)
