---
title: DataPass Server
emoji: 🎫
colorFrom: indigo
colorTo: purple
sdk: docker
app_file: Dockerfile
pinned: false
---

# DataPass MCP Server

**Your pass to private datasets.**

This is the MCP (Model Context Protocol) server that powers DataPass. It handles:

- Token validation for dataset access
- SQL and natural language query execution via DuckDB
- Stripe payment integration
- Subscription ledger management

## MCP Endpoint

Connect your MCP client (Claude Desktop, Cursor, etc.) to:

```
sse: https://your-space.hf.space/sse
```

## Available MCP Tools

### Public Tools
- `get_dataset_catalog` - Browse available datasets

### Authenticated Tools (require DataPass token)
- `get_my_datasets` - View your subscribed datasets
- `query_dataset` - Run SQL queries on datasets
- `query_dataset_natural_language` - Ask questions in plain English
- `get_dataset_sample` - Preview dataset structure

## Configuration

This Space requires the following **Secrets** (Settings → Variables and secrets):

| Secret | Description |
|--------|-------------|
| `HF_TOKEN` | HF token with write access to ledger dataset |
| `ADMIN_API_SECRET` | Shared secret for admin API authentication |
| `LEDGER_DATASET_ID` | Dataset ID for subscription ledger (e.g., `username/datapass-ledger`) |
| `STRIPE_SECRET_KEY` | Stripe API key for payments |
| `STRIPE_WEBHOOK_SECRET` | Stripe webhook signing secret |
| `FRONTEND_URL` | URL to DataPass frontend (for landing page redirect) |

## Security Model

- Dataset files never leave Hugging Face
- Every request validates the DataPass token
- Query results are capped (no `SELECT *` dumps)
- Access automatically expires after subscription period