Descarga video y audio desde URLs de medios públicos o extrae metadatos mediante una API REST asíncrona.
También conocido como huntapi/huntapi-mcp, huntapi-mcp, @huntapi/mcp
- Stars
- 0
- Herramientas
- 7
- Descargas, 30 días
- 327
- Última versión
- 0.1.0
- Último commit
- 11 nov 2026
- Licencia
- MIT
¿Qué es HuntAPI MCP?
HuntAPI es un MCP server. Descarga video y audio desde URLs de medios públicos o extrae metadatos mediante una API REST asíncrona. Expone 7 herramientas, como audio_download, jobs, media_metadata.
Resumen generado a partir del README del proyecto
Acerca del MCP server de HuntAPI
HuntAPI ofrece una forma para que los desarrolladores interactúen con una API de descarga de medios a través del Model Context Protocol. Este MCP server permite que clientes de IA como Claude, Cursor, Windsurf y VS Code realicen tareas como descargar audio y video desde URLs públicas o extraer metadatos de archivos multimedia. Funciona como una API REST asíncrona, lo que significa que los usuarios pueden iniciar una tarea y consultar su progreso más tarde.
Los usuarios pueden desplegar este servidor de múltiples maneras. Puedes usar la versión alojada en mcp.huntapi.com a través de streamable HTTP proporcionando una API key en el header, o puedes ejecutarlo localmente usando stdio con Node.js 20 o superior. Las configuraciones locales requieren una API key de HuntAPI pasada a través de variables de entorno. El servidor incluye herramientas específicas para gestionar estas tareas, incluyendo audio_download, video_download, media_metadata y jobs para consultar el estado. También ofrece herramientas de utilidad como usage para revisar los créditos de la cuenta y stats para monitorear la salud de la infraestructura.
Qué puedes hacer con él
- 1Extraer información de mediosPide a la IA que recupere metadatos de una URL de medios específica sin descargar el archivo completo.
- 2Descargar archivos de audio o videoIndica al cliente que inicie un proceso de descarga de un archivo de video o audio desde un enlace público.
- 3Monitorear el progreso de la descargaHaz que la IA verifique el estado actual y el porcentaje de completado de un job de medios activo.
- 4Consultar el saldo de créditos de la cuentaSolicita las estadísticas de uso actuales y los créditos restantes de tu cuenta de HuntAPI.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar HuntAPI MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar HuntAPI MCP en Claude Code
$ claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcpInstalar HuntAPI MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instalar HuntAPI MCP en VS Code
.vscode/mcp.json
{
"servers": {
"huntapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instalar HuntAPI MCP en VS Code CLI
$ code --add-mcp '{"name":"huntapi-mcp","type":"stdio","command":"npx","args":["-y","@huntapi/mcp"],"env":{"HUNTAPI_API_KEY":"<YOUR_HUNTAPI_API_KEY>"}}'Instalar HuntAPI MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Instalar HuntAPI MCP en Codex
$ codex mcp add huntapi-mcp --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' -- npx -y @huntapi/mcpInstalar HuntAPI MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.huntapi-mcp] command = "npx" args = ["-y", "@huntapi/mcp"] [mcp_servers.huntapi-mcp.env] HUNTAPI_API_KEY = "<YOUR_HUNTAPI_API_KEY>"
Instalar HuntAPI MCP en Gemini CLI
$ gemini mcp add -s user -e 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp npx -- -y @huntapi/mcpInstalar HuntAPI MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"huntapi-mcp": {
"command": "npx",
"args": [
"-y",
"@huntapi/mcp"
],
"env": {
"HUNTAPI_API_KEY": "<YOUR_HUNTAPI_API_KEY>"
}
}
}
}Herramientas de HuntAPI MCP 7
Detectado desde el READMEaudio_downloadjobsmedia_metadatastatsusagevideo_downloadwait_for_job
| audio_download | — | |
| jobs | — | |
| media_metadata | — | |
| stats | — | |
| usage | — | |
| video_download | — | |
| wait_for_job | — |
Configuración
HUNTAPI_API_KEYObligatorioSecretoHuntAPI API key.
| Nombre | Descripción | Tipo |
|---|---|---|
| HUNTAPI_API_KEY | HuntAPI API key. | ObligatorioSecreto |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSAprobado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubHuntAPI MCP Server
Official Model Context Protocol server for the HuntAPI media download API.
Download video and audio from public media URLs, or extract their metadata, with one async REST API.
It lets Claude, Cursor, VS Code, Windsurf and any MCP client call the API as tools. Runs over stdio (local) or Streamable HTTP (self-hosted).
Requirements
Hosted server (recommended)
HuntAPI runs this server for you at https://mcp.huntapi.com/ (Streamable HTTP). Send your API key in the x-api-key header; nothing to install.
claude mcp add --transport http huntapi https://mcp.huntapi.com/ --header "x-api-key: YOUR_API_KEY"
{
"mcpServers": {
"huntapi": {
"url": "https://mcp.huntapi.com/",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
The hosted server and this package expose the same API; run the package locally when you want stdio, your own network egress, or to self-host it.
Run it locally
Claude Code
claude mcp add huntapi --env HUNTAPI_API_KEY=YOUR_API_KEY -- npx -y @huntapi/mcp
Claude Desktop, Cursor, Windsurf and other clients
Add the server to the client's MCP configuration (claude_desktop_config.json, .cursor/mcp.json…):
{
"mcpServers": {
"huntapi": {
"command": "npx",
"args": ["-y", "@huntapi/mcp"],
"env": {
"HUNTAPI_API_KEY": "YOUR_API_KEY"
}
}
}
}
VS Code
{
"servers": {
"huntapi": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@huntapi/mcp"],
"env": {
"HUNTAPI_API_KEY": "${input:huntapi-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "huntapi-api-key",
"description": "HuntAPI API key",
"password": true
}
]
}
Claude Desktop extension
Download the .mcpb bundle from the releases page and open it; Claude Desktop asks for your API key.
Docker
docker build -t huntapi-mcp .
docker run -i --rm -e HUNTAPI_API_KEY=YOUR_API_KEY huntapi-mcp
Tools
| Tool | Description |
|---|---|
audio_download |
Download audio from a URL via HuntAPI and receive a job id. |
jobs |
Poll status, progress (0–100), and result of an async HuntAPI job. |
media_metadata |
Extract metadata from a media URL without downloading the file. |
stats |
Infrastructure health for an engine or endpoint over the last hour. Not scoped to your account or tenant. Enabled per account: HTTP 403 means contact support to activate it. |
usage |
Retrieve real-time usage statistics and credit balance for your Huntapi account. |
video_download |
Video Download |
wait_for_job |
Wait for an async download job to finish. |
Every tool that calls the API consumes credits. JSON results are returned as text; images are returned inline and other files (PDF…) as embedded resources, up to 4 MB.
Streamable HTTP
npx @huntapi/mcp --http --port 3000
The endpoint is POST /mcp (stateless, JSON responses). Each client sends its own key in the x-api-key header (or Authorization: Bearer <key>); the server never uses a key of its own. It binds to 127.0.0.1 by default and rejects browser origins unless you allow them — put it behind TLS before exposing it.
createHttpHandler() is exported for Fetch-compatible runtimes (Cloudflare Workers, Deno, Bun):
import { createHttpHandler } from "@huntapi/mcp";
export default { fetch: createHttpHandler({ allowedOrigins: [] }) };
Security
- The API key is read from
HUNTAPI_API_KEY(stdio) or the request headers (HTTP) and removed from error messages. - Content fetched from websites is untrusted: the server instructions tell the model to treat it as data, not instructions.
- See SECURITY.md to report a vulnerability.
Development
npm install
npm test
npm run build
npx @modelcontextprotocol/inspector node dist/stdio.js
Built on the SDK
The server uses the official Node.js SDK (@huntapi/sdk).
All HuntAPI SDKs
| SDK | Package | Install |
|---|---|---|
| Node.js | @huntapi/sdk |
npm install @huntapi/sdk |
| Python | huntapi |
pip install huntapi |
| Go | huntapi-go |
go get github.com/huntapi/huntapi-go |
| .NET | HuntApi |
dotnet add package HuntApi |
| Ruby | huntapi |
gem install huntapi |
| PHP | huntapi/sdk |
composer require huntapi/sdk |
| Java | huntapi-java |
build from source, see its README |
| CLI | @huntapi/cli |
npm install -g @huntapi/cli |
| MCP server | @huntapi/mcp |
npx -y @huntapi/mcp |
License
MIT — see LICENSE.
Preguntas sobre HuntAPI MCP
¿Cómo agrego HuntAPI MCP a Claude Code?
Ejecuta claude mcp add --env 'HUNTAPI_API_KEY=<YOUR_HUNTAPI_API_KEY>' huntapi-mcp -- npx -y @huntapi/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego HuntAPI MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona HuntAPI MCP?
Expone 7 herramientas, incluidas audio_download, jobs, media_metadata, stats, usage.
¿Cómo uso HuntAPI con Claude Desktop?
Puedes descargar el bundle .mcpb desde la página de releases y abrirlo, o añadir el MCP server a tu archivo de configuración usando npx.
¿Puedo extraer metadatos sin descargar el archivo completo?
Sí, la herramienta media_metadata te permite extraer metadatos de una URL de medios sin necesidad de descargar el archivo.
¿Cuáles son los requisitos para ejecutar el servidor?
Necesitas Node.js versión 20 o superior y una API key válida de HuntAPI.
¿Usar las herramientas tiene algún costo?
Sí, cada herramienta que realiza una llamada a la API consume créditos.