Singular focus. Precise target.

Photons are single-file TypeScript MCP servers that supercharge AI assistants with focused capabilities. Each photon delivers ONE thing exceptionally well - from filesystem operations to cloud integrations.

Built on the Model Context Protocol (MCP), photons are:

• 📦 One-command install via Photon CLI
• 🎯 Laser-focused on singular capabilities
• ⚡ Zero-config with auto-dependency management
• 🔌 Universal - works with Claude Desktop, Claude Code, and any MCP client

This is the official Photon marketplace maintained by Portel. It comes pre-configured with Photon - no manual setup needed.

Already available to you:

• ✅ Pre-installed with Photon
• ✅ Automatically updated
• ✅ Production-ready photons
• ✅ Community-maintained

Want to contribute? We welcome contributions! Submit pull requests for:

• 🐛 Bug fixes to existing photons
• ✨ Enhancements and new features
• 📦 New photons to add to the marketplace
• 📝 Documentation improvements

Repository: github.com/portel-dev/photons

Total: 34 photons ready to use

npm install -g @portel/photon

photon add filesystem
photon add git
photon add aws-s3

# Run as MCP server
photon mcp filesystem

# Get config for your MCP client
photon get filesystem --mcp

Output (paste directly into your MCP client config):

{
  "mcpServers": {
    "filesystem": {
      "command": "photon",
      "args": ["mcp", "filesystem"]
    }
  }
}

Add the output to your MCP client's configuration. Consult your client's documentation for setup instructions.

That's it! Your AI assistant now has 34 focused tools at its fingertips.

This marketplace is also available as a Claude Code plugin, enabling seamless installation of individual photons directly from Claude Code's plugin manager.

# In Claude Code, run:
/plugin marketplace add portel-dev/photons

Once added, you can install individual photons:

# Install specific photons you need
/plugin install filesystem@photons-marketplace
/plugin install git@photons-marketplace
/plugin install knowledge-graph@photons-marketplace

• 🎯 Granular Installation: Install only the photons you need
• 🔄 Auto-Updates: Plugin stays synced with marketplace
• ⚡ Zero Config: Photon CLI auto-installs on first use
• 🛡️ Secure: No credentials shared with AI (interactive setup available)
• 📦 Individual MCPs: Each photon is a separate installable plugin

This marketplace doubles as a Claude Code plugin through automatic generation:

# Generate marketplace AND Claude Code plugin files
photon maker sync --claude-code

This single command:

1. Scans all .photon.ts files
2. Generates .marketplace/photons.json manifest
3. Creates .claude-plugin/marketplace.json for Claude Code
4. Generates documentation for each photon
5. Creates auto-install hooks for seamless setup

Result: One source of truth, two distribution channels (Photon CLI + Claude Code).

Photons are laser-focused modules - each does ONE thing exceptionally well:

• 📁 Filesystem - File operations
• 🐙 Git - Repository management
• ☁️ AWS S3 - Cloud storage
• 📅 Google Calendar - Calendar integration
• 🕐 Time - Timezone operations
• ... and more

Each photon delivers singular focus to a precise target.

Key Features:

• 🎯 Each photon does one thing perfectly
• 📦 34 production-ready photons available
• ⚡ Auto-installs dependencies
• 🔧 Works out of the box
• 📄 Single-file design (easy to fork and customize)

For each MCP server:

1. Find and clone the repository
2. Install dependencies manually
3. Configure environment variables
4. Write MCP client config JSON by hand
5. Repeat for every server

# Install from marketplace
photon add filesystem

# Get MCP config
photon get filesystem --mcp

Output (paste directly into your MCP client config):

{
  "mcpServers": {
    "filesystem": {
      "command": "photon",
      "args": ["mcp", "filesystem"]
    }
  }
}

That's it. No dependencies, no environment setup, no configuration files.

Difference:

• ✅ One CLI, one command
• ✅ Zero configuration
• ✅ Instant installation
• ✅ Auto-dependencies
• ✅ Consistent experience

For Claude Users:

photon add filesystem git github-issues
photon get --mcp  # Get config for all three

Add to Claude Desktop → Now Claude can read files, manage repos, create issues

For Teams:

photon add postgres mongodb redis
photon get --mcp

Give Claude access to your data infrastructure

For Developers:

photon add docker git slack
photon get --mcp

Automate your workflow through AI

# List all photons
photon get

# Search by keyword
photon search calendar

# View details
photon get google-calendar

# Upgrade all
photon upgrade

Create your own marketplace:

# 1. Organize photons
mkdir company-photons && cd company-photons

# 2. Generate marketplace
photon maker sync

# 3. Share with team
git push origin main

# Team members use:
photon marketplace add company/photons
photon add your-internal-tool

Built with singular focus. Deployed with precise targeting.

Made with ⚛️ by Portel