MattVOLTA/volta-data-mcp

Volta Data MCP Server

Centralized MCP (Model Context Protocol) server providing standardized data access tools for Volta AI agents.

Overview

This server enables multiple AI agents across the Volta team to access company data, performance metrics, and interaction history through a unified API. Built with FastMCP and integrated with Supabase.

Features

Company Data Tools

• get_company_basics - Retrieve fundamental company information
• search_companies - Search and filter companies by various criteria
• get_company_team - Get team members and their roles

Coming Soon

• Performance analysis tools
• Interaction history tools
• Form submission analysis
• Risk identification tools

Setup

1. Environment Configuration

Copy .env.example to .env and configure:

SUPABASE_URL=your_supabase_project_url
SUPABASE_SERVICE_KEY=your_supabase_service_key
MCP_SERVER_NAME=volta-data-mcp
MCP_SERVER_VERSION=0.1.0

2. Installation

# Install dependencies
pip install -r requirements.txt

# Run the server
python -m src.server

3. Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "volta-data-mcp": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/volta-data-mcp",
      "env": {
        "SUPABASE_URL": "your_supabase_url",
        "SUPABASE_SERVICE_KEY": "your_service_key"
      }
    }
  }
}

Tools Reference

get_company_basics

Retrieve fundamental company information.

Parameters:

• company_id (string, required): Company UUID
• include_inactive (boolean, optional): Include inactive companies (default: false)

Returns: Company profile with basic info, status, location, and key metrics

search_companies

Search and filter companies by criteria.

Parameters:

• query (string, optional): Text search
• company_type (string, optional): startup, investment_fund, etc.
• traction_level (string, optional): idea, mvp, paying_customers, etc.
• operating_status (string, optional): operating, closed, acquired
• province (string, optional): Location filter
• limit (number, optional): Maximum results (default: 10)

Returns: List of companies matching criteria

get_company_team

Get team members and their roles.

Parameters:

• company_id (string, required): Company UUID
• limit (number, optional): Maximum results (default: 10)
• include_details (boolean, optional): Include bios, LinkedIn (default: true)

Returns: List of team members with roles and details

Architecture

• Framework: FastMCP (Python MCP SDK)
• Database: Supabase PostgreSQL
• Deployment: Railway (planned)
• Language: Python 3.9+

Development

Project Structure

src/
├── server.py              # Main MCP server
├── tools/
│   └── company_data.py    # Company data tools
└── utils/
    └── supabase_client.py # Database client setup

Adding New Tools

1. Create tool class in appropriate module under src/tools/
2. Add tool methods to main server in src/server.py
3. Update this README with tool documentation

Security

• All secrets managed via environment variables
• Comprehensive .gitignore prevents credential commits
• Service key provides row-level security through Supabase

License

Private - Volta Ventures Inc.