# ALT/FNDATA

ALT/FNDATA lets an AI assistant search auction results, compare prices, track market movement, and value selected luxury and collectible items.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: altfndata
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/altfndata/altfndata-mcp
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/altfndata

## What it does

ALT/FNDATA connects an assistant to auction records covering watches, jewelry, gemstones, handbags, vehicles, wine, art, fashion, books, coins, and other categories from 100+ auction houses. Natural-language requests can retrieve sales, inspect table structure, calculate market figures, follow price movement, or check an item against comparable results.

The server exposes 9 read-only tools. They cover table queries, whole-market search, realized-price statistics, period trends, model indexes, item price checks, and alert information. You can use the hosted MCP endpoint at `https://mcp.altfndata.com/mcp` or run the package locally with `uvx altfinance-mcp`.

An ALT/FNDATA API key is required. API-key access cannot create or enable price alerts, so alert setup uses the signed-in account in the ALT/FNDATA app.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://mcp.altfndata.com/mcp`
- Environment variables: `ALTFINANCE_API_KEY`, `ALTFINANCE_API_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 altfinance-mcp https://mcp.altfndata.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ALTFINANCE_API_KEY=<ALTFINANCE_API_KEY> --env ALTFINANCE_API_URL=<ALTFINANCE_API_URL> --transport stdio altfndata -- uvx altfinance-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from altfinance-mcp <command>

### Codex

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

2. **Platform CLI**
```bash
codex mcp add altfndata --env ALTFINANCE_API_KEY=<ALTFINANCE_API_KEY> --env ALTFINANCE_API_URL=<ALTFINANCE_API_URL> -- uvx altfinance-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from altfinance-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "altfndata": {
            "url": "https://mcp.altfndata.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "altfndata": {
            "command": "uvx",
            "args": [
                "altfinance-mcp"
            ],
            "env": {
                "ALTFINANCE_API_KEY": "<ALTFINANCE_API_KEY>",
                "ALTFINANCE_API_URL": "<ALTFINANCE_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from altfinance-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "altfndata": {
            "type": "http",
            "url": "https://mcp.altfndata.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "altfndata": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "altfinance-mcp"
            ],
            "env": {
                "ALTFINANCE_API_KEY": "<ALTFINANCE_API_KEY>",
                "ALTFINANCE_API_URL": "<ALTFINANCE_API_URL>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from altfinance-mcp <command>

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add -e ALTFINANCE_API_KEY=<ALTFINANCE_API_KEY> -e ALTFINANCE_API_URL=<ALTFINANCE_API_URL> altfndata uvx altfinance-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from altfinance-mcp <command>

## When to use it
- search auction comparables
- calculate median and percentile prices
- track a model’s price movement
- check the value of watches or cars
- search sales across all categories

## Example prompts
- Find the most expensive Rolex watches sold after 2020.
- Show market figures for Patek Philippe watches sold at Phillips.
- Estimate a fair range for a white-dial Rolex Daytona 116500.

## Similar
- [True Value Rankings](https://affpapa.org/en/nevibecode/mcp/info-rpjo-true-value-rankings.md) — MCP server · 744 installs
- [configurator](https://affpapa.org/en/nevibecode/skills/configurator.md) — skill · 1100 installs
- [SerialHunt](https://affpapa.org/en/nevibecode/mcp/serialhunt.md) — MCP server
- [qrcoin](https://affpapa.org/en/nevibecode/skills/qrcoin.md) — skill · 206 installs
- [ALT](https://affpapa.org/en/nevibecode/mcp/alt.md) — MCP server · 302 installs
- [pp-ebay](https://affpapa.org/en/nevibecode/skills/pp-ebay.md) — skill · 273 installs

---
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
