Atomic APIs

Servidor MCP de AtomicAPIs

Un servidor de Protocolo de Contexto de Modelo (MCP) que expone 17 herramientas de micro-API de nivel de producción para asistentes de IA. Construido con .NET 9 y el SDK oficial de ModelContextProtocol.

MCP permite que asistentes de IA como Claude invoquen estas herramientas de forma nativa durante la conversación, sin necesidad de solicitudes HTTP, claves de API ni código repetitivo en el lado del cliente.

Instalación rápida

Un clic para Claude Desktop

Agrega esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "atomicapis": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/atomicapis-mcp-server/src"]
    }
  }
}

Un clic para Claude Code

claude mcp add atomicapis -- dotnet run --project /path/to/atomicapis-mcp-server/src

Un clic para Kiro

Herramientas

Herramienta	Método	Descripción
WebToMarkdownTools	ExtractMarkdown	Extrae cualquier URL y convierte la página a Markdown limpio. Elimina navegación, pie de página, scripts y HTML no esencial para minimizar tokens. Protegido contra SSRF con un límite de página de 5 MB.
EmailShieldTools	VerifyEmail	Verifica si una dirección de correo es desechable o proviene de un dominio quemado conocido. Valida el formato, consulta una lista de dominios seleccionados y verifica los registros MX mediante DNS.
TimezoneTools	ResolveTimezone	Convierte latitud/longitud a datos completos de zona horaria, incluida la zona horaria IANA, el desplazamiento UTC, el estado de horario de verano, la hora local actual y la próxima transición.
SchemaSniffTools	InferSchema	Detecta automáticamente el formato (JSON, CSV, XML) de un payload e infiere su esquema: nombres de campos, tipos, nulabilidad y anidamiento.
ProductSchemaTools	GenerateProductSchema	Genera datos estructurados de Producto JSON-LD para SEO. Produce tanto JSON-LD sin procesar como una etiqueta <script> lista para incrustar.
CsvSurgeonTools	CleanCsv	Limpia, normaliza y deduplica datos CSV. Corrige la codificación, normaliza encabezados, colapsa espacios en blanco, rellena/trunca filas y, opcionalmente, normaliza formatos de fecha.
UtmLinkTools	CloakLink	Crea URL de seguimiento con etiquetas UTM ocultas. Codifica parámetros de campaña en un token corto y los decodifica de vuelta.
JsonRepairTools	RepairJson	Corrige JSON dañado de salidas de LLM: comas finales, claves sin comillas, comillas simples, corchetes faltantes. Opcionalmente valida contra un esquema JSON.
TokenCounterTools	CountTokens	Cuenta tokens para múltiples modelos de LLM (GPT-4, Claude, Llama, Mistral, Gemini). Estima costos, uso de la ventana de contexto y señala cuando el texto excede el límite del modelo.
EmailAuthGraderTools	GradeEmailAuth	Audita la configuración de autenticación de correo de un dominio: SPF, DKIM, DMARC, MTA-STS y BIMI. Devuelve una calificación con letra (A–F), puntuación y recomendaciones accionables.
PiiRedactorTools	RedactPii	Detecta y redacta información de identificación personal en texto. Maneja correos electrónicos, SSN, tarjetas de crédito, números de teléfono, direcciones IP, direcciones físicas, fechas de nacimiento y URL.
PhoneValidatorTools	ValidatePhone	Valida números de teléfono internacionales en más de 30 países. Devuelve formato E.164, información del país, tipo de número (móvil/fijo) y salida formateada.
TaxIdValidatorTools	ValidateTaxId	Valida IVA e identificadores fiscales para UE, EE. UU., Reino Unido, Australia e India. Los números de IVA de la UE se verifican contra el servicio VIES cuando está disponible.
PromptInjectionTools	DetectPromptInjection	Puntúa texto para detectar intentos de inyección de prompts y jailbreak. Utiliza coincidencia de patrones y análisis heurístico en múltiples categorías de ataque. Devuelve una puntuación de riesgo (0–100) con segmentos marcados.
SemanticSearchTools	SemanticSearch	Compara una consulta de búsqueda con un catálogo de elementos utilizando similitud TF-IDF. Admite coincidencia difusa, expansión de sinónimos y ponderación de títulos configurable.
RelatedContentTools	FindRelatedContent	Encuentra elementos de contenido relacionados en un corpus utilizando similitud TF-IDF y Jaccard. Umbrales configurables, refuerzo de categorías y desgloses de puntuación opcionales.
VoiceTaskParserTools	ParseTasks	Extrae tareas accionables de transcripciones de voz. Identifica verbos de acción, asignados, prioridades, plazos y puntuaciones de confianza. Maneja hasta 100,000 caracteres.

Primeros pasos

Requisitos previos

• SDK de .NET 9

Compilar

cd src
dotnet build

Ejecutar

cd src
dotnet run

El servidor se comunica a través de stdio utilizando el protocolo MCP JSON-RPC. Está diseñado para ser lanzado por un cliente compatible con MCP (por ejemplo, Claude Desktop, Claude Code, Kiro o cualquier host MCP). Consulta Instalación rápida arriba para la configuración.

Arquitectura

src/
├── Program.cs              # MCP server entry point (stdio transport)
├── Tools/                  # MCP tool definitions (17 tools)
│   ├── WebToMarkdownTools.cs
│   ├── EmailShieldTools.cs
│   ├── TimezoneTools.cs
│   └── ...
└── Engines/                # Core logic (pure computation, no HTTP/DI concerns)
    ├── CsvCleaner.cs
    ├── SchemaInferrer.cs
    ├── EmailValidator.cs
    └── ...

Las herramientas definen la interfaz MCP: descripciones de parámetros, validación y formato de respuestas. Cada herramienta delega en una clase Engine que contiene la lógica de negocio pura sin dependencias del framework.

Dependencias

Paquete	Versión	Propósito
ModelContextProtocol	1.1.0	SDK de MCP para .NET
Microsoft.Extensions.Hosting	9.0.6	Constructor de host para DI y ciclo de vida
HtmlAgilityPack	1.12.4	Análisis de HTML (Web a Markdown)
ReverseMarkdown	5.2.0	Conversión de HTML a Markdown
GeoTimeZone	6.1.0	Búsqueda de coordenadas a zona horaria
DnsClient	1.8.0	Consultas DNS (calificación de autenticación de correo)

Licencia

MIT