Servidor MCP para Trabajar en una Startup 🚀

Un servidor de Protocolo de Contexto de Modelo (MCP) para consultar empleos y empresas de Y Combinator a través de Work at a Startup.

Este servidor MCP equipa a los asistentes de IA (Claude Desktop, Cursor, Gemini CLI, Antigravity) con acceso directo para buscar startups de YC, explorar listados de empleos activos, inspeccionar pilas tecnológicas, filtrar por habilidades requeridas, rangos salariales, equidad y estado de patrocinio de visa estadounidense.

🛠️ Características y Herramientas Disponibles

El servidor proporciona 4 herramientas FastMCP:

1. search_jobs: Busca listados de empleos de startups de YC con filtros avanzados.

   • query (str): Término de búsqueda (p. ej. "backend", "AI agent", "Rust").

   • role (Optional[str]): Rol funcional ("eng", "design", "product", "ops", "sales", "marketing").

   • eng_type (Optional[str]): Especialización en ingeniería ("be", "fe", "fs", "ml", "mobile").

   • job_type (Optional[str]): Tipo de empleo (p. ej. "fulltime", "contract").

   • min_experience (Optional[int]): Nivel máximo de experiencia requerido en años (min_experience <= N).

   • max_team_size (Optional[int]): Tamaño máximo del equipo de la empresa (company_team_size <= N).

   • batch (Optional[str]): Lote de YC (p. ej. "W24", "S23").

   • remote (bool): Filtro para posiciones remotas (True / False).

   • visa (bool): Filtro para patrocinio de visa estadounidense (True / False).

   • page (int): Índice de página (por defecto 0).

   • limit (int): Número de empresas por página (por defecto 10).

2. get_company_details: Obtiene el perfil detallado de una empresa de YC y sus roles abiertos.

   • company_id (int): ID único de la empresa de YC.

   • Devuelve: Lote de YC, sitio web, tamaño del equipo, ubicación, fundadores, descripción de la pila tecnológica y listados de empleos abiertos activos.

3. get_job_details: Recupera los detalles completos de un listado de empleo específico.

   • job_id (int): ID único del empleo.

   • Devuelve: Descripción completa del empleo (Markdown), tipo de rol, nivel de experiencia, rango salarial, rango de equidad, estado de visa, habilidades requeridas y URL de aplicación directa.

4. filter_jobs_by_skills: Filtra empleos activos que coincidan con una lista de tecnologías/habilidades objetivo.

   • skills (List[str]): Lista de habilidades/tecnologías (p. ej., ["Python", "PyTorch", "PostgreSQL"]).

   • limit (int): Número máximo de empleos coincidentes a devolver (por defecto 10).

Related MCP server: recruiting-jobs-mcp

💻 Inicio Rápido e Instalación

Opción 1: Usando uvx o pipx (Recomendado)

Ejecuta al instante sin clonar ni instalar manualmente:

uvx workatastartup-mcp

Opción 2: Usando pip

pip install workatastartup-mcp
workatastartup-mcp

Opción 3: Desarrollo / Instalación desde el Código Fuente

git clone https://github.com/MIt9/workatastartup-mcp.git
cd workatastartup-mcp

python3 -m venv .venv
source .venv/bin/activate
pip install -e .

⚙️ Configuración para Clientes MCP

Claude Desktop

Añade a tu claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "workatastartup": {
      "command": "uvx",
      "args": [
        "workatastartup-mcp"
      ]
    }
  }
}

Cursor / VS Code / Gemini CLI / Antigravity

{
  "mcpServers": {
    "workatastartup": {
      "command": "uvx",
      "args": [
        "workatastartup-mcp"
      ]
    }
  }
}

🧪 Ejecutando Pruebas

# Run unit & integration tests
.venv/bin/pytest

# Run fast unit tests only (skip live API calls)
.venv/bin/pytest -m "not integration"

📜 Licencia

Distribuido bajo la Licencia MIT.