# HuntAPI

> HuntAPI is a freemium MCP server for design and media. Async video and audio download plus metadata extraction for public media URLs. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://www.huntapi.com
- **Repository:** https://github.com/huntapi/huntapi-mcp
- **MCP Registry name:** com.huntapi/mcp
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

Instead of returning files directly, the API starts a job and the agent polls it. `video_download` and `audio_download` each return a job id, `jobs` reports status, progress from 0 to 100 and the result, and `wait_for_job` blocks until completion. `media_metadata` extracts metadata from a URL without downloading anything.

The site lists mp4, webm and mkv for video and mp3 for audio, and says it handles public content from major video platforms. Billing is one credit per video regardless of length, size or bandwidth, with a free plan and Premium, Startup and Startup+ tiers whose prices are not shown on the page.

Run the hosted server at mcp.huntapi.com with an `x-api-key` header, or the `@huntapi/mcp` package over stdio. Pairing the downloads with transcription or frame extraction is one use the vendor suggests.

## Features

- **Job-based downloads:** Video and audio requests return a job id to poll.
- **Metadata only:** Extract details from a media URL without fetching the file.
- **Flat credit pricing:** One credit per video, with no bandwidth charge.
- **Wait helper:** Block until an async job finishes.
- **Usage reporting:** Check credit balance and usage from the client.

## Good for

- Archive public videos for compliance
- Pull audio to transcribe
- Build datasets of video metadata
- Save media for offline playback in an app

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.huntapi.com/
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.huntapi.com/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.huntapi.com/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.huntapi.com/"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.huntapi.com/"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.huntapi.com/"
    }
  }
}
```

## Tools

- `video_download`: Start a video download job.
- `audio_download`: Start an audio download job.
- `media_metadata`: Extract metadata without downloading.
- `jobs`: Poll status, progress and result of a job.
- `wait_for_job`: Wait for a job to finish.
- `usage`: Usage and credit balance.
- `stats`: Infrastructure health; enabled per account.

## FAQ

### How are downloads billed?

One credit per video, whatever its length or size.

### Is the download instant?

No. It is asynchronous: you get a job id and poll its status.

### Which formats?

Video as mp4, webm or mkv and audio as mp3.

### Can I try it free?

Yes. Registering gives free credits with no card.

### Is HuntAPI free?

HuntAPI has a free plan, with paid plans for more usage or features.

### How do I add HuntAPI to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.huntapi.com/

### What are the best alternatives to HuntAPI?

The closest alternatives to HuntAPI are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/huntapi
