@valaclaims/mcp

MCP (Model Context Protocol) server for Vala - connect AI assistants like Claude and Cursor to your Vala account.

What is MCP?

MCP is Anthropic's open protocol for connecting AI assistants to external tools and data sources. This package allows AI assistants to interact with Vala to manage clients, tasks, and documents through natural language.

Installation

No global install required - runs via npx:

npx @valaclaims/mcp

Setup

1. Generate an API Key

1. Log in to Vala
2. Go to Settings → Integrations
3. Click Create API Key
4. Give it a name and select the scopes you need:
   • clients:read - List and view clients
   • documents:read - View client documents
   • documents:write - Upload documents
   • tasks:read - List and view tasks
   • tasks:write - Create tasks
5. Copy the API key (you'll only see it once!)

2. Configure Your AI Assistant

Cursor IDE

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vala": {
      "command": "npx",
      "args": ["-y", "@valaclaims/mcp"],
      "env": {
        "VALA_API_KEY": "vala_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "vala": {
      "command": "npx",
      "args": ["-y", "@valaclaims/mcp"],
      "env": {
        "VALA_API_KEY": "vala_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Custom API URL (Staging or Self-Hosted)

If you're using a different Vala instance:

{
  "mcpServers": {
    "vala": {
      "command": "npx",
      "args": ["-y", "@valaclaims/mcp"],
      "env": {
        "VALA_API_KEY": "vala_sk_xxxxxxxxxxxxxxxx",
        "VALA_API_URL": "https://staging.valaclaims.com"
      }
    }
  }
}

3. Start Using

After configuration, restart your AI assistant. You can now ask things like:

• "List my Vala clients"
• "Show me documents for [email protected]"
• "Create a task to follow up with Jane Doe"
• "What tasks are currently in progress?"

Available Tools

| Tool | Description | Required Scope | |------|-------------|----------------| | list_clients | List all clients with optional filters | clients:read | | get_client | Get client details by email | clients:read | | list_documents | List documents for a client | documents:read | | upload_document | Upload a document to a client | documents:write | | list_tasks | List tasks with optional filters | tasks:read | | create_task | Create a new task | tasks:write |

Available Resources

The MCP server also exposes resources that AI assistants can read:

| URI | Description | |-----|-------------| | vala://clients | All clients | | vala://clients/{email} | Single client details | | vala://clients/{email}/documents | Client's documents | | vala://tasks | All tasks |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | VALA_API_KEY | Yes | - | Your Vala API key | | VALA_API_URL | No | https://app.valaclaims.com | Vala API base URL |

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

Support

• Documentation: docs.valaclaims.com
• Email: [email protected]