# HuntAPI

The HuntAPI MCP server for Claude Code downloads audio or video from public URLs and retrieves media metadata. It connects to media-processing requests through agent tools.

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

## What it does

HuntAPI provides tools to download audio or video from public links, retrieve media metadata, and check asynchronous job status. Agents can also query account usage and credit balance. Each API call uses credits.

Connect to the hosted HuntAPI server over HTTP, or run the package locally with `npx`. Local use requires Node.js 20 or newer and a HuntAPI API key. The local server supports stdio and Streamable HTTP. Its HTTP mode binds to `127.0.0.1` by default; TLS is required before exposing it publicly.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.huntapi.com/`
- Environment variables: `HUNTAPI_API_KEY` — 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**
```bash
claude mcp add mcp -e HUNTAPI_API_KEY=<HUNTAPI_API_KEY> -- npx -y @huntapi/mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http huntapi https://mcp.huntapi.com/
```

### Codex

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

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

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

## When to use it
- download audio from a public link
- fetch video from a media URL
- retrieve metadata without downloading the file
- check an asynchronous download job

## Example prompts
- Download audio from this public link and return the job ID.
- Fetch the video at this URL.
- Get the media metadata from this link without downloading the file.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 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
