# Hyperplexity

# Hyperplexity — AI Research Tables with Citations and Confidence Scores

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add hyperplexity/production

# Browse available tools
npx -y @smithery/cli@latest tool list hyperplexity/production

# Get full schema for a tool
npx -y @smithery/cli@latest tool get hyperplexity/production get_balance

# Call a tool
npx -y @smithery/cli@latest tool call hyperplexity/production get_balance '{}'
```

## Direct MCP Connection

Endpoint: `https://hyperplexity.run.tools`

**Required config:**
- `X-Api-Key` (header) — Your API key from hyperplexity.ai/account — new accounts get $20 free credits.

## Tools (18)

- `get_balance` — Return the current account credit balance in USD.
- `get_usage` — Return API usage history. Dates in YYYY-MM-DD format.
- `upload_file` — Upload a local file to Hyperplexity.
- `confirm_upload` — Confirm the upload and detect matching prior configs.
- `create_job` — Create a validation job.
- `get_job_status` — One-shot job status check. Prefer wait_for_job for tracking long-running jobs.
- `get_job_messages` — Fetch live progress messages for a running job.
- `wait_for_job` — Wait for a job to reach a terminal state, emitting live MCP progress notifications.
- `approve_validation` — Approve a preview and start full validation processing.
- `get_results` — Fetch the final validated/enriched results for a completed job.
- `get_reference_results` — Fetch reference-check sub-results for a completed job (if applicable).
- `update_table` — Re-run validation on a previously processed table (update in place).
- `reference_check` — Submit a reference-check job for a text snippet or uploaded file.
- `start_table_maker` — Start a Table Maker conversation to generate a research table.
- `get_conversation` — Poll a conversation for new messages or a status change.
- `send_conversation_reply` — Send a user reply in an ongoing conversation (interview or table-maker).
- `refine_config` — Refine the generated validation config using natural language instructions.
- `wait_for_conversation` — Wait for a conversation turn to complete, emitting live synthetic progress.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get hyperplexity/production <tool-name>
```

## Prompts (3)

- `generate_table` (description, columns) — Generate a new research table from a natural language description.
- `validate_file` (file_path, instructions) — Validate an existing Excel or CSV file with AI fact-checking.
- `fact_check_text` (text) — Fact-check a text passage by extracting and verifying its claims.