# Dataville

Links AI agents to ten public data sources through one interface. Useful for pulling SEC filings, arXiv research, and US Census numbers directly into chats.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: datavilleorg
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/datavilleorg/dataville-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/dataville

## What it does

The server exposes ten external datasets, including arXiv, SEC EDGAR, US Census, PyPI, OpenAlex, and Project Gutenberg. MCP clients interact with them through four read-only operations: checking source catalogs, inspecting table schemas, running text searches, and sending SQL queries.

The `query_dataville` tool handles SQL `SELECT` statements with filtering, joins, and pagination capped at 1,000 rows per call. Datasets for `census` and `news` are excluded from SQL queries. Dataville fetches both live on each search.

You can link directly to the remote HTTP endpoint without local packages. Running the local stdio version instead requires Node.js LTS and a valid `DATAVILLE_API_KEY`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.dataville.com/mcp`
- Environment variables: `DATAVILLE_API_KEY`, `DATAVILLE_API_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http dataville-mcp https://api.dataville.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env DATAVILLE_API_KEY=<DATAVILLE_API_KEY> --env DATAVILLE_API_BASE_URL=<DATAVILLE_API_BASE_URL> --transport stdio dataville -- npx -y @dataville/dataville-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add dataville --url https://api.dataville.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add dataville --env DATAVILLE_API_KEY=<DATAVILLE_API_KEY> --env DATAVILLE_API_BASE_URL=<DATAVILLE_API_BASE_URL> -- npx -y @dataville/dataville-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dataville": {
            "url": "https://api.dataville.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "dataville": {
            "command": "npx",
            "args": [
                "-y",
                "@dataville/dataville-mcp"
            ],
            "env": {
                "DATAVILLE_API_KEY": "<DATAVILLE_API_KEY>",
                "DATAVILLE_API_BASE_URL": "<DATAVILLE_API_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dataville": {
            "type": "http",
            "url": "https://api.dataville.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "dataville": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@dataville/dataville-mcp"
            ],
            "env": {
                "DATAVILLE_API_KEY": "<DATAVILLE_API_KEY>",
                "DATAVILLE_API_BASE_URL": "<DATAVILLE_API_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http dataville https://api.dataville.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e DATAVILLE_API_KEY=<DATAVILLE_API_KEY> -e DATAVILLE_API_BASE_URL=<DATAVILLE_API_BASE_URL> dataville npx -y @dataville/dataville-mcp
```
Replace <…> with your own values

## When to use it
- inspect corporate reports and financial disclosures from SEC EDGAR
- locate preprints on arXiv and extract paper summaries
- retrieve county demographic metrics from the US Census
- look up package licenses and latest releases on PyPI

## Example prompts
- Check the latest SEC EDGAR filing for Apple and summarize revenue details.
- Search arXiv for retrieval-augmented generation papers and show abstracts.
- Find the median household income for Travis County, Texas in US Census data.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md