HuntAPI — Claude Code MCP server: features and setup
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.
MIT updated 2026-11-11
claude mcp add mcp -e HUNTAPI_API_KEY=<HUNTAPI_API_KEY> -- npx -y @huntapi/mcpWhat HuntAPI 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.
What it helps with
- 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 for the agent
- 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.
How to install HuntAPI
1Platform CLI
claude mcp add mcp -e HUNTAPI_API_KEY=<HUNTAPI_API_KEY> -- npx -y @huntapi/mcpReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http huntapi https://mcp.huntapi.com/1Platform CLI: remote server
codex mcp add huntapi --url https://mcp.huntapi.com/2Platform CLI
codex mcp add huntapi --env HUNTAPI_API_KEY=<HUNTAPI_API_KEY> -- npx -y @huntapi/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"huntapi": {
"url": "https://mcp.huntapi.com/"
}
}
}{
"mcpServers": {
"huntapi": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<HUNTAPI_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"huntapi": {
"type": "http",
"url": "https://mcp.huntapi.com/"
}
}
}{
"servers": {
"huntapi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<HUNTAPI_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http huntapi https://mcp.huntapi.com/2Platform CLI
gemini mcp add -e HUNTAPI_API_KEY=<HUNTAPI_API_KEY> huntapi npx -y @huntapi/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about HuntAPI
How do I install HuntAPI in Claude Code?
For a local setup, run claude mcp add --env HUNTAPI_API_KEY=<HUNTAPI_API_KEY> --transport stdio huntapi -- npx -y @huntapi/mcp. A HuntAPI API key is required.
What does HuntAPI do?
It gives an agent tools to download audio or video from public URLs, retrieve media metadata, and track asynchronous jobs.
What does HuntAPI require?
It requires a HuntAPI API key. Local setup also needs Node.js 20 or newer; the hosted server uses HTTP.