MCP for developers · GA v1.0.0

El conocimiento ejecutivo de Fractional cLevel, como tools para tu agente IA.

Servidor MCP self-service. Búsqueda semántica sobre la metodología cLB, diagnóstico de PyMEs, catálogo de productos. Auth bearer, OAuth 2.0 + PKCE, rate limiting real, scopes granulares. Free tier disponible — registro en 30 segundos.

Registrarme (free)Ver tools disponibles Changelog →

Qué es y para qué sirve

Fractional cLevel es la práctica de dirección ejecutiva externa de Yair Levy Wald: un director que cubre las 8 dimensiones del negocio (legal, infraestructura, ecosistema digital, marca, equipo, IA governance, etc.) para dueños de PyMEs.

Detrás de la práctica hay un Knowledge Engine: ~200 documentos canónicos (cLB Blueprints, casos, playbooks, decisiones), vectorizados, accesibles por scope. El MCP expone ese engine como tools para que tus agentes IA invoquen — Claude Desktop, Cursor, tu propio bot, lo que sea.

Casos reales: Kontrol.ar lo usa para enriquecer su bot interno con metodología cLB. Partners externos lo usan para enriquecer chatbots de coaching para PyMEs.

Tools expuestos

search_knowledgemcp.read.clb

Búsqueda semántica sobre la metodología cLevel Blueprints (cLB). Recibe una pregunta, devuelve los docs más relevantes con BP, similarity y referencias.

query (string), bp_filter? (-1..5), max_results? (1..10)

analyze_clientmcp.read.clb

Recibe contexto de un negocio (rubro, facturación, problema) y devuelve un diagnóstico estructurado: programa recomendado, BPs críticos, siguiente paso.

descripcion (string), rubro? (retail|servicios), facturacion_mensual? (string)

search_productsmcp.read.agencia

Catálogo de productos y programas de Fractional cLevel: LTM, ETM, LTE, ETE, Modelador, Bot de calificación, etc. Incluye precio y landing.

query? (string), line? (productos-ia|programas|servicios), pricing_model? (fixed|consultar), max_results? (1..50)

get_productmcp.read.agencia

Ficha completa de un producto por SKU (descripción larga, todos los campos).

sku (string)

Tiers y rate limits

Tier	Mensual	Por minuto	Acceso	Notas
Free	100 calls/mes	10/min	Self-service	Para evaluación y prototipos.
User	500 calls/mes	30/min	Contactar	Uso personal de un dev.
Reseller	10.000 calls/mes	100/min	Contactar	Para partners que integran a sus clientes.
Enterprise	50.000 calls/mes	300/min	Contactar	Cuenta dedicada con SLA.

Self-service da scope mcp.read.clb (metodología pública). Para scopes mcp.read.agencia o superior, contactar yair@levywald.com.

Cómo conectarte (3 pasos)

OAuth 2.0 con PKCE. Tier free, scope mcp.read.clb. El access_token resultante es una API key MCP — usala como Bearer header contra /mcp.

1) Registrar tu app

curl -X POST https://www.fractionalclevel.ai/api/mcp/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mi App",
    "email": "dev@miapp.com",
    "use_case": "Bot de coaching para PyMEs basado en cLB.",
    "redirect_uris": ["https://miapp.com/oauth/callback"]
  }'

# Response:
# {
#   "client_id": "mcpc_...",
#   "client_secret": "mcps_...",  ← guardalo, no se vuelve a mostrar
#   "next_steps": { ... }
# }

2) OAuth authorize → code

GET https://www.fractionalclevel.ai/api/mcp/oauth/authorize?
  client_id=mcpc_...&
  redirect_uri=https://miapp.com/oauth/callback&
  response_type=code&
  scope=mcp.read.clb&
  code_challenge=<BASE64URL(SHA256(verifier))>&
  code_challenge_method=S256&
  state=<random>

→ 302 redirect a redirect_uri con ?code=<auth_code>&state=<...>

3) Intercambiar code por access_token

curl -X POST https://www.fractionalclevel.ai/api/mcp/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "authorization_code",
    "code": "<auth_code>",
    "redirect_uri": "https://miapp.com/oauth/callback",
    "code_verifier": "<verifier>",
    "client_id": "mcpc_...",
    "client_secret": "mcps_..."
  }'

# → { "access_token": "mk_...", "token_type": "Bearer", "scope": "mcp.read.clb", ... }

Ejemplos

curl

curl https://www.fractionalclevel.ai/mcp \
  -H "Authorization: Bearer mk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "search_knowledge",
      "arguments": {
        "query": "como armar el BP3 de marca y marketing",
        "max_results": 3
      }
    },
    "id": 1
  }'

JavaScript / TypeScript (MCP SDK)

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://www.fractionalclevel.ai/mcp'),
  { requestInit: { headers: { Authorization: `Bearer ${process.env.FC_MCP_KEY}` } } },
);

const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

const result = await client.callTool({
  name: 'search_knowledge',
  arguments: { query: 'BP3 marca y marketing', max_results: 3 },
});
console.log(result.content);

Python (raw)

import os, requests

resp = requests.post(
    "https://www.fractionalclevel.ai/mcp",
    headers={
        "Authorization": f"Bearer {os.environ['FC_MCP_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "jsonrpc": "2.0",
        "method": "tools/call",
        "params": {
            "name": "search_knowledge",
            "arguments": {"query": "BP3 marca y marketing", "max_results": 3},
        },
        "id": 1,
    },
)
print(resp.json())

Casos de uso reales

Kontrol.ar

Enriquece su bot interno de coaching con la metodología cLB. Scope mcp.read.kontrol — accede a cLB + namespace propio.

Bot del sitio

fractionalclevel.ai usa internal scope para alimentar el calificador de leads con la base completa.

¿Tu caso no encaja en self-service?

Para tier reseller / enterprise (incluye scope mcp.read.agencia con catálogo de productos, mcp.read.all, etc.) escribime directo.

yair@levywald.com

Manifest público: /mcp · changelog: /api/mcp/changelog · registro: POST /api/mcp/register