Skip to main content

MCP server for the Loreto skill generation API — use generate_skills inside Claude Code

Project description

loreto-mcp

MCP server for the Loreto skill generation API.

Gives Claude Code (and other MCP-compatible agents) a generate_skills tool that extracts structured skill packages from any YouTube video, article, PDF, or image — directly inside your coding session.


What this does

When connected, Claude Code can call:

  • generate_skills — Extract ranked skill packages from a URL. Each skill comes back as a SKILL.md, README.md, reference files, and a test script. Save them to .claude/skills/ and Claude will apply them automatically on future tasks.
  • get_quota — Check how many API calls remain in your current billing period.

Setup

1. Get an API key

Sign up at loreto.io to get your free API key (lor_...).

2. Install

pip install loreto-mcp

Or use directly without installing (requires uv):

uvx loreto-mcp

3. Configure Claude Code

User-scoped (works across all your projects) — add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "loreto": {
      "command": "uvx",
      "args": ["loreto-mcp"],
      "env": {
        "LORETO_API_KEY": "lor_..."
      }
    }
  }
}

Project-scoped (shared with your team) — add to .mcp.json at your project root:

{
  "mcpServers": {
    "loreto": {
      "command": "uvx",
      "args": ["loreto-mcp"],
      "env": {
        "LORETO_API_KEY": "${LORETO_API_KEY}"
      }
    }
  }
}

Then set LORETO_API_KEY in your shell environment and teammates do the same with their own keys.

4. Verify

Restart Claude Code and run /mcp — you should see loreto listed with generate_skills and get_quota.


Usage

Once connected, just ask Claude Code naturally:

Use Loreto to extract skills from https://www.youtube.com/watch?v=...
Check my Loreto quota before we start.
Extract skills from this article and save them to .claude/skills/

Claude will call generate_skills, receive the full skill package contents, and can write them directly to your project.


Configuration

Environment variable Required Default Description
LORETO_API_KEY Yes Your Loreto API key (lor_...)
LORETO_BASE_URL No https://api.loreto.io Override for local development

Plans

Free and paid plans are available. See loreto.io/pricing for current limits.


License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

loreto_mcp-0.1.2.tar.gz (6.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

loreto_mcp-0.1.2-py3-none-any.whl (6.5 kB view details)

Uploaded Python 3

File details

Details for the file loreto_mcp-0.1.2.tar.gz.

File metadata

  • Download URL: loreto_mcp-0.1.2.tar.gz
  • Upload date:
  • Size: 6.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for loreto_mcp-0.1.2.tar.gz
Algorithm Hash digest
SHA256 34ac04bf4481b8fdfae6135cd56abe142a27a6e15833074b34dc556f722f7241
MD5 e8ccd3071469eab49f929d5e3511bd19
BLAKE2b-256 772aad6a389fa4bc4dc383a3c0325d4b03bbfd288bc903e2302db17ab251655d

See more details on using hashes here.

File details

Details for the file loreto_mcp-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: loreto_mcp-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 6.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for loreto_mcp-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1dc56edaf3227e3eba986592a234e4b250f444ea448fe3be588d28ecc0204001
MD5 5534c8ab1710c3c379b256c64a368983
BLAKE2b-256 12f2fce244c10cb2409b5a1aac167a98697c6657abd3d68f0869d9e8aa07b210

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page