VIKK Legal AI MCP Server

MCP (Model Context Protocol) server for integrating VIKK Legal AI with Claude Desktop and Claude Code.

Overview

This MCP server provides tools for:

• Generating legal documents (demand letters, cease & desist, notices, agreements)
• Chatting with VIKK Legal AI assistant
• Extracting text from PDF files
• Managing chat sessions

Quick Start (Recommended)

The easiest way to use this MCP server is with uvx - no installation required!

Claude Desktop Configuration

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

{
  "mcpServers": {
    "vikk-legal": {
      "command": "uvx",
      "args": ["vikk-legal-mcp"],
      "env": {
        "VIKK_API_URL": "https://lab.vikk.live",
        "VIKK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Then restart Claude Desktop (Cmd+Q on macOS).

Get an API Key

1. Contact VIKK AI to get access
2. Log in to https://lab.vikk.live
3. Navigate to Admin > API Keys
4. Create and copy your API key

Alternative Installation

Install from PyPI

pip install vikk-legal-mcp

Install from Source

git clone https://github.com/vikkaird/vikkai-agentic-server.git
cd vikkai-agentic-server/mcp-server
uv sync

Configuration

Set environment variables before running:

export VIKK_API_URL="http://localhost:8000"  # Your VIKK API URL
export VIKK_API_KEY="vk_live_xxxxx"          # Your API key from VIKK admin panel
export VIKK_TIMEOUT="60"                      # Request timeout in seconds (optional)

Getting an API Key

1. Log in to VIKK admin panel
2. Navigate to Admin > API Keys
3. Create a new API key
4. Copy the full key (shown only once)

Usage

Run Standalone

uv run vikk_mcp/server.py

Test with MCP Inspector

npx @modelcontextprotocol/inspector vikk_mcp/server.py

Claude Desktop Integration

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "vikk-legal": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/vikkai-agentic-server/mcp-server",
        "run",
        "vikk_mcp/server.py"
      ],
      "env": {
        "VIKK_API_URL": "https://lab.vikk.live",
        "VIKK_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

After saving, restart Claude Desktop completely (Cmd+Q on macOS, not just close window).

Claude Code Integration

# In your Claude Code settings or .claude/settings.json
{
  "mcpServers": {
    "vikk-legal": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-server", "run", "vikk_mcp/server.py"],
      "env": {
        "VIKK_API_URL": "https://lab.vikk.live",
        "VIKK_API_KEY": "vk_live_your_key_here"
      }
    }
  }
}

Available Tools

Document Generation

Tool	Description
generate_document	Create legal documents (demand letters, cease & desist, notices, etc.)
list_document_templates	List available document types and required fields

Chat

Tool	Description
chat_with_vikk	Have a conversation with VIKK Legal AI
get_session_history	Retrieve conversation history for a session
list_chat_sessions	List recent chat sessions

PDF Processing

Tool	Description
extract_pdf_text	Extract text from a local PDF file

Utility

Tool	Description
get_api_usage	Check API usage and rate limits

Available Resources

URI	Description
vikk://templates	Document templates reference
vikk://usage	API usage statistics

Examples

Generate a Demand Letter

"Generate a demand letter for unpaid rent. The landlord is John Smith at 123 Main St,
Anytown CA 90210. The tenant is Jane Doe at 456 Oak Ave, Anytown CA 90211.
The amount owed is $2,500 for March and April rent."

Chat with VIKK

"Chat with VIKK about how to write a cease and desist letter for trademark infringement."

Extract PDF Text

"Extract the text from /Users/me/Documents/contract.pdf"

Troubleshooting

Server not appearing in Claude Desktop

1. Verify the config file path and JSON syntax
2. Use absolute paths (not relative)
3. Fully restart Claude Desktop (Cmd+Q on macOS)
4. Check logs: tail -f ~/Library/Logs/Claude/mcp*.log

API errors

1. Verify VIKK_API_KEY is set correctly
2. Check that the API URL is accessible
3. Ensure your API key has not expired
4. Check rate limits with get_api_usage

Connection refused

1. Verify the VIKK server is running
2. Check the API URL is correct (include protocol: http/https)
3. Check firewall settings

Development

Project Structure

mcp-server/
├── pyproject.toml          # Project configuration
├── README.md               # This file
└── vikk_mcp/
    ├── __init__.py
    ├── config.py           # Environment configuration
    ├── server.py           # Main MCP server with all tools
    └── tools/
        └── __init__.py

Running Tests

# Test the server responds
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | uv run vikk_mcp/server.py

License

MIT License - See LICENSE file for details.