Optare MCP Server

Model Context Protocol server exposing Optare SDK to AI agents like Claude Desktop.

Installation

npm install -g @optare/mcp-server
# or
npx @optare/mcp-server

Quick Setup for Claude Desktop

1. Get your API key from id.optare.one/portal/settings

2. Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):

{
  "mcpServers": {
    "optare": {
      "command": "npx",
      "args": ["-y", "@optare/mcp-server"],
      "env": {
        "OPTARE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

Available Tools

optare_check_license

Check if current user has access to a feature.

Input:

• feature (string) - Feature key to check

Output: Boolean access status

Example:

Check if I have access to "ai-reports"

optare_list_products

List all available products.

Output: List of products with names and slugs

optare_bootstrap_app

One-shot setup for new applications. Creates:

• OAuth Client
• API Key
• Default Product
• Webhook (optional)

Input:

• appName (string) - Application name
• redirectUri (string) - OAuth callback URL
• webhookUrl (optional string) - Webhook endpoint

Output: Complete .env configuration

Example:

Bootstrap a new app called "My SaaS App" with callback http://localhost:3000/api/auth/callback

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | OPTARE_API_KEY | Yes | Your API key from the dashboard | | OPTARE_API_URL | No | Custom API URL (defaults to https://id.optare.one) |

Security

This server is designed with strict security boundaries:

• ❌ No file system access - Cannot read/write files
• ✅ Read-only license checks - Safe entitlement verification
• ✅ Scoped API access - Only exposed safe operations
• ❌ No destructive actions - Cannot delete data

SSE Mode (Web/Agentic IDEs)

Start in Server-Sent Events mode for web-based AI tools:

OPTARE_API_KEY=your-key npx @optare/mcp-server sse

Then connect your agent to: http://localhost:3000/sse

Troubleshooting

"API Key not set"

Set the OPTARE_API_KEY environment variable in your MCP config.

"License check API not implemented"

The backend licensing API endpoints are not yet available. This is expected.

Documentation

• MCP Protocol Docs
• Optare Documentation

License

MIT