@taqql/mcp

A Model Context Protocol (MCP) stdio server that connects to Taqql's MCP Endpoint for secure, authenticated access to your Taqql data.

Quick Start

Get started instantly with npx (no installation required):

npx @taqql/mcp --api-key="<your-key-here>" --endpoint="https://your-taqql-instance.com/mcp"

Usage

Prerequisites

1. You need a valid Taqql API key with MCP access
2. The API key should be associated with your user account and organization
3. Access to your Taqql MCP endpoint URL

Command Line Options

The server supports several command line arguments for easy configuration:

# Basic usage with API key and endpoint
npx @taqql/mcp --api-key="your_mcp_api_key_here" --endpoint="https://your-taqql-instance.com/mcp"

# Show help
npx @taqql/mcp --help

# Show version
npx @taqql/mcp --version

Available Options:

• -k, --api-key <key> - Your Taqql API key (required)
• -e, --endpoint <url> - Your Taqql MCP endpoint URL (required)
• -h, --help - Show help message
• -v, --version - Show version information

Environment Variables

Alternatively, you can use environment variables:

export TAQQL_API_KEY=your_mcp_api_key_here
export TAQQL_MCP_ENDPOINT=https://your-taqql-instance.com/mcp

# Then run without arguments:
npx @taqql/mcp

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

Using command line arguments:

{
  "mcpServers": {
    "taqql": {
      "command": "npx",
      "args": ["@taqql/mcp", "--api-key", "your_mcp_api_key_here", "--endpoint", "https://your-taqql-instance.com/mcp"]
    }
  }
}

Using environment variables:

{
  "mcpServers": {
    "taqql": {
      "command": "npx",
      "args": ["@taqql/mcp"],
      "env": {
        "TAQQL_API_KEY": "your_mcp_api_key_here",
        "TAQQL_MCP_ENDPOINT": "https://your-taqql-instance.com/mcp"
      }
    }
  }
}

Architecture

MCP Client → stdio → Local MCP Server → HTTPS → Taqql API

1. Local stdio MCP server (this package) receives MCP requests via stdio
2. Authenticates using your API key
3. Forwards requests to Taqql's API over HTTPS
4. API validates your authentication and permissions
5. Operations respect your organization permissions and data access controls

Security

• API keys are validated server-side
• All operations respect organization-based data access controls
• HTTPS communication between local server and Taqql API
• No direct data storage on local environment

API Key Management

Your API key determines:

• User context: Which user the operations run as
• Organization context: Which organization's data you can access
• Permissions: What operations you're allowed to perform

Contact your Taqql administrator to obtain an API key with MCP access and endpoint URL.

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

License

This software is proprietary and available free of charge to authorized Taqql customers with valid API keys. See LICENSE for full terms.

For licensing questions, contact: [email protected]