Start here
Welcome to metahub
metahub is a registry of small, focused capabilities you can drop into the AI tools you already use (Claude Code, Cursor, Antigravity, and other clients that support the underlying formats). Each capability is called an artifact. Artifacts come in four flavors (skills, MCP servers, agents, and plugins), and the registry handles all of them under one roof.
You don't need an account to browse. You don't need an account to install public artifacts. Sign in only if you want personalized installs, the ability to leave reviews, or to publish your own.
Browse openly
No paywall, no signup. Every public artifact is searchable, previewable, and installable.
Verified at the SHA
Listings are pinned to a specific git commit so what you install is exactly what was tested.
Real ratings
Star ratings come from people who actually installed it. No SEO spam, no shadowbanning.
Concepts
What's an artifact?
An artifact is a small, self-contained package that gives an AI tool a new ability. Think of it like a browser extension, but for the AI in your editor or terminal.
For example:
- A skill called
pdfteaches your AI client how to read and summarize PDF files. - An MCP server called
filesystemlets your client read and write files within a sandboxed directory. - An agent called
code-reviewercan be invoked from your Node app to leave inline PR comments. - A plugin bundles several skills + an MCP server into a single install: for example, a complete
frontend-devkit.
Note
Artifacts ship as source code from public GitHub repositories. No mystery binaries: the registry shows the repo URL and the exact commit your install will use.
The catalog
The four kinds
Pick the right kind for what you're trying to do. The kind determines where the files land on your machine and how Claude invokes them.
- skillintent-triggered
- A markdown file with a frontmatter trigger. Claude reads it when the conversation matches the description. Best for narrow, well-scoped tasks: "summarize a PDF," "convert image to webp," "explain SQL plan."
- mcptool server
- A long-lived process exposing tools over the Model Context Protocol. Claude can call those tools any time. Best for external system access: filesystem, GitHub API, database, browser automation.
- agentNode import
- A reusable TypeScript agent you import into your own code. Best for headless automation: code review, ticket triage, scheduled batch jobs.
- pluginbundle
- A grouping of skills + an MCP server + a settings file, installed as one unit. Best for cohesive toolkits like "Python data work" or "frontend development."
Recommended
Install metahub in your AI client
The fastest way to use metahub is to plug its MCP server into the AI tool you already have open. Once installed, you can ask your AI things like “find me a skill for parsing PDFs” or “what metahub artifacts do I have installed?”, no terminal step.
Pick your client and copy the snippet:
claude mcp add metahub -- npx -y @metahub/mcp-serverRun once. Claude Code picks it up on next start.
Then just ask
Restart your AI client, then prompt: “find me a skill for PDFs”. The AI will call metahub and hand back results. For a full tour of what the server can do, see the MCP page.
Want to script installs, automate from CI, or pin versions in dotfiles? Use the CLI below.
Alternative
Install the mh CLI
Use this for CI, scripts, and reproducible setups. The MCP server is the faster path for interactive use.
mh is a tiny Node CLI that handles install, list, update, and uninstall. It works on macOS, Linux, and Windows (WSL). You need Node 20 or newer.
Install with npm
npm install -g @metahub/cli
mh --versionPrefer pnpm? Run pnpm add -g @metahub/cli. Prefer bun? bun add -g @metahub/cli.
Sign in (optional)
mh loginThe CLI starts a GitHub Device Flow and waits for you to enter the displayed code in your browser. Your token lives at ~/.metahub/config.json.
You can skip signing in and still install any public artifact. The benefit of signing in is:
- Leave reviews and ratings
- Bookmark artifacts to a personal list
- Personalized observability on the portal: "the 6 artifacts this CLI has installed"
Step 2
Find an artifact
Three ways to find what you need:
- Browse the registry at /browse, then filter by kind, tag, freshness, or popularity.
- Search by keyword:bash
mh search pdf mh search "image conversion" mh search --kind=mcp database - Inspect details before installing:bash
mh show skills/pdfPrints the artifact's description, version, repo URL, published SHA, tags, and recent star rating.
Looking for a specific feature?
The registry homepage surfaces what's trending. New here? Start with popular skills or MCP servers.
Step 3
Install an artifact
One command:
mh install skills/pdf
# or
mh install mcps/filesystem
mh install agents/code-reviewer
mh install plugins/frontend-devThe CLI will:
- Fetch the published SHA from the registry
- Download the source from GitHub
- Place files at the conventional path for that kind
- Wire any required hooks (MCP settings, plugin manifest)
- Mint a per-install API key and store it at
~/.metahub/installs.json
Where things land
- skill
- Files copied to your AI tool's skills directory (e.g.
~/.claude/skills/<slug>/for Claude Code). Any tool that supports the SKILL.md convention picks them up automatically on next launch. - mcp
- An entry added to your client's MCP config under
mcpServers; paths vary (e.g.~/.claude/settings.json,~/.cursor/mcp.json, etc.). Restart your client to activate. - agent
- Cloned to
~/.metahub/agents/<slug>/. You import it into your Node project; the CLI prints the exact import statement. - plugin
- Unpacked to your AI tool's plugin directory (e.g.
~/.claude/plugins/<slug>/). Its bundled skills + MCP server are wired in one step.
Verifying
List everything currently installed:
mh listShows kind, slug, installed version, source repo, and last invocation time. A green dot means the artifact has been used in the last 7 days.
Step 4
Use what you installed
Once installed, artifacts are invoked by the host AI tool; you don't usually call them by hand.
- skills
- Just ask your AI tool something that matches the skill's description. If you installed
skills/pdf, say "summarize this PDF" and the host (Claude Code, Cursor, etc.) picks it up automatically. - MCP servers
- Tools are available as soon as your client restarts. Claude will offer them when a tool call is appropriate; no special trigger phrase needed.
- agents
- Import into your Node code and call the agent's exported function. The artifact's README has the exact snippet.
- plugins
- Work like the sum of their parts: skills behave like skills, the MCP behaves like an MCP, all from one install.
Maintenance
Updates & versions
Each install is pinned to the SHA that was published. You won't wake up to a broken artifact because the author force-pushed; updates are explicit.
mh update skills/pdf # update one artifact
mh update --all # update everything
mh outdated # show what has newer versions availableTo remove an artifact:
mh uninstall skills/pdfThe CLI removes the files, scrubs the MCP server entry, and revokes the per-install API key.
Community
Reviews & ratings
Every artifact has a 1–5 star rating and a threaded review feed. Open the artifact's detail page and scroll down, or click Write a review to leave one of your own.
Anonymous or verified: your call
Reviews work without a signup. Pick the path that fits:
- Guest
- Type a name + body and hit submit. The review posts immediately with an unverified label. Rate-limited per IP to discourage spam.
- Verified GitHub
- Click Sign in with GitHub in the review form. We pull your handle + avatar, and the review shows a green Verified badge. Your identity is the OAuth-attested one; you can't impersonate someone else's handle.
Sign-in is optional
We don't gate reviews behind "you must have installed first"; that would punish people who installed before the catalog existed. We do show a Verified badge on signed-in reviews so you can weight them differently.
Reviews flow back to the developer's dashboard within seconds. Developers can hide individual reviews from their portal, but they can't edit them or filter by rating.
Important
Privacy & telemetry
When an artifact is invoked, the bundled SDK reports a small amount of usage data back to the developer who published it. You can audit exactly what's collected and turn it off any time.
What's collected
- Which slug + version was invoked
- Invocation duration in milliseconds
- Which model handled the invocation (e.g. claude-opus-4-7)
- Which tools fired alongside (Read, Bash, ...)
- Which other artifact (if any) was handed off to
- An opaque
installIdso the developer can count unique installs
What's never collected
- The text of your prompts
- Tool inputs or outputs
- File paths, filenames, or file contents
- Environment variables
- Your GitHub identity (unless you signed in to review)
Source-visible
The SDK is open source. You can read the exact payload it emits; see packages/core/src/ingest.ts in the repo.
Opting out
Two levels of opt-out, both local-only:
mh config set telemetry off # disable ingest entirely
mh config set telemetry-handoff off # keep invocations, drop handoff graphEffective immediately. No payload leaves your machine once telemetry is off, verifiable with lsof -i :443 while invoking an artifact.
Stuck?
Troubleshooting
- skill not loading
- Restart your AI tool: skills are read at launch, not hot-reloaded. Confirm the file exists at the tool's skills directory (e.g.
~/.claude/skills/<slug>/SKILL.mdfor Claude Code). - MCP not connecting
- Run
mh doctor mcps/<slug>: it spawns the MCP server in foreground and reports the stderr if it crashes. 90% of the time it's a missing env var. - install fails with 404
- The artifact may have been unpublished. Run
mh search <slug>to confirm it's still in the registry, thenmh cache clearand retry. - permission denied on global install
- Either use a node version manager (asdf, fnm, nvm), or install with a user prefix:
npm config set prefix ~/.npm-global && export PATH=$PATH:~/.npm-global/bin.
Still stuck?
Open an issue against the artifact's source repo (link is on the detail page) or, if it's a CLI bug, against github.com/metahub-ai/metahub-monorepo.
Quick answers
FAQ
Is it free?
Browsing the registry, installing public artifacts, leaving reviews: all free. Developers pay nothing to publish either. Paid artifacts and managed-key features are coming later.
Can I install private artifacts?
Yes: anything marked unlisted or private that you have access to (you're the publisher, or you've been shared a direct link) is installable with the same mh install flow.
Does the CLI need network access?
Only at install, update, and uninstall time. Once installed, artifacts run entirely locally. Telemetry batches send every 30 seconds when telemetry is on, but they fail silently if you don't have network, so they don't block invocations.
How do I publish my own?
Head to the developer docs, or just open the portal and paste a GitHub URL. The portal walks you through the checks and publish flow.
Building artifacts?
Developer docs live on the portal.
Publishing, manifest format, observability dashboards, reviews moderation, and personal access tokens are all documented in the developer portal: sign in once with GitHub and you're in.