Metadata-Version: 2.4
Name: policynumbers-mcp
Version: 0.1.2
Summary: MCP server exposing the PolicyNumbers insurance verification API as AI tools
Author: PolicyNumbers
License: MIT
Keywords: mcp,insurance,verification,ai,claude
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.28.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-mock>=3.12; extra == "dev"

# policynumbers-mcp

MCP server that exposes the [PolicyNumbers](https://policynumbers.com) insurance
verification API as tools for Claude and other MCP-compatible AI agents.

## Installation

```bash
pip install policynumbers-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `verify_policy` | Synchronous policy verification (format + regulatory checks) |
| `verify_policy_with_document` | Async verification with document OCR analysis |
| `extract_document_fields` | Extract structured fields from an insurance document |
| `verify_batch` | Submit multiple policies in one request |
| `get_usage` | Check credit balance and plan limits |

## Claude Desktop configuration

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "policynumbers": {
      "command": "policynumbers-mcp",
      "env": {
        "POLICYNUMBERS_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

Get your API key at https://policynumbers.com/api

## Environment variables

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `POLICYNUMBERS_API_KEY` | Yes | — | Your PolicyNumbers API key |
| `POLICYNUMBERS_BASE_URL` | No | `https://api.policynumbers.com` | Override for staging/dev |
