Semantic API

Descubrimiento de API en lenguaje natural: busca más de 700 capacidades de API, obtén endpoints, configuración de autenticación y fragmentos de código.

Documentación

Servidor MCP de Semantic API

Un servidor MCP (Model Context Protocol) que permite a Claude, ChatGPT y otros agentes LLM buscar y descubrir APIs usando lenguaje natural a través de Semantic API. Solicita cualquier capacidad de API en inglés sencillo y obtén detalles de endpoints, parámetros, información de autenticación y fragmentos de código.

Instalación

pip install semanticapi-mcp

O ejecuta directamente con uvx:

uvx semanticapi-mcp

Configuración

Obtén una Clave de API

Regístrate en semanticapi.dev para obtener tu clave de API.

Variables de Entorno

VariableRequeridaPredeterminadaDescripción
SEMANTIC_API_KEYTu clave de Semantic API
SEMANTIC_API_URLNohttps://semanticapi.devAnulación de la URL base de la API

Claude Desktop

Agrega a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "semanticapi": {
      "command": "uvx",
      "args": ["semanticapi-mcp"],
      "env": {
        "SEMANTIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

O si está instalado con pip:

{
  "mcpServers": {
    "semanticapi": {
      "command": "semanticapi-mcp",
      "env": {
        "SEMANTIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Herramientas

semantic_query

Busca una capacidad de API usando lenguaje natural.

Entradas:

  • query (cadena, requerida) — Lo que quieres hacer, p. ej. "enviar un correo electrónico con Gmail"
  • auto_discover (booleano, opcional, predeterminado: true) — Descubrir automáticamente nuevas APIs si es necesario

Ejemplo: "Encuéntrame una API para convertir divisas en tiempo real"

semantic_discover

Descubrimiento profundo de un proveedor/API específico por nombre e intención.

Entradas:

  • provider_name (cadena, requerida) — Nombre del proveedor de la API, p. ej. "stripe", "twilio"
  • user_intent (cadena, opcional) — Lo que quieres hacer con esta API

Ejemplo: Descubre las capacidades de Stripe para "procesar un reembolso"

semantic_discover_url

Analiza cualquier API desde su URL de documentación.

Entradas:

  • url (cadena, requerida) — URL de la documentación de la API
  • user_intent (cadena, opcional) — Lo que quieres hacer con esta API

Ejemplo: Analiza https://docs.example.com/api para generar una configuración de proveedor

Relacionados

Licencia

MIT