mcp-setup SKILL.md skillA

mcp-setup from vellum-ai/vellum-assistant is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add vellum-ai/vellum-assistant/mcp-setup@git:20260914.25fbd03

Pins git:20260914.25fbd03 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
vellum-ai/vellum-assistant
Path
skills/mcp-setup/SKILL.md
Versions recorded
7
Latest version
git:20260914.25fbd03, committed Sep 14, 2026
First version recorded
Apr 17, 2026
Size
6,263 bytes
Repository stars
1,467
License
MIT

Add, authenticate, list, and remove MCP (Model Context Protocol) servers — connect any external tool or service that publishes an MCP endpoint to the assistant.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

Configure MCP servers to give the assistant access to any external tool or service that publishes an MCP endpoint.

**DO NOT** run exploratory commands. Do not check available CLI commands, search for bun/npx/node, or investigate transport types. Follow the steps below exactly and stop when done. (Looking up a service's MCP endpoint URL in its own documentation is allowed when the service is not in the recipe table, per Step 3.)

## When to Use

USE THIS SKILL WHEN:

- User asks to connect any external tool or service via MCP
- User asks "what MCP servers / integrations do I have?"
- An MCP tool returns an auth error → run `assistant mcp auth <name>`
- User wants to disconnect an integration

## Prefer Native OAuth Integration (check this first)

Many services have built-in OAuth integrations that are simpler and more reliable than MCP. Before setting up MCP, check whether the service already has a native OAuth provider:

```
assistant oauth providers list
```

If the service appears in that list, connect it natively instead of using MCP:

```
assistant oauth connect <provider>
```

**Only use MCP when:**

- The service is not in `assistant oauth providers list`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add vellum-ai/vellum-assistant/mcp-setup@sha256:490ee1ed55ff69a5

The line at the top of this page pins the label git:20260914.25fbd03, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_qru24krbmjqxblni.svg)](https://markdownregistry.com/a/art_qru24krbmjqxblni)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Apr 17, 2026 and Sep 14, 2026, about one every 25 days.

versioncommittedcommitsizeaudit
git:20260914.25fbd03 latest2026-09-14 25fbd03 6,263 BA view · diff
git:20260909.be0d0e72026-09-09 be0d0e7 6,282 BA view · diff
git:20260827.bd79e072026-08-27 bd79e07 6,758 BA view · diff
git:20260612.d6066772026-06-12 d606677 6,630 BA view · diff
git:20260609.73a43e02026-06-09 73a43e0 6,628 BA view · diff
git:20260603.ff934d92026-06-03 ff934d9 2,645 BA view · diff
git:20260417.2a99d8e2026-04-17 2a99d8e 2,616 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6263 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

vellum-ai/vellum-assistant · 1,467 stars · license MIT · pushed 2026-10-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qru24krbmjqxblni
GET https://markdownregistry.com/api/v1/resolve?ref=vellum-ai/vellum-assistant/mcp-setup
GET https://markdownregistry.com/api/v1/blob/490ee1ed55ff69a58ba7c3b06e9fbbc4f15f3a68ac3761e7b6b62c5b68610931

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from vellum-ai/vellum-assistant

add-mcp-integration SKILL.md skill
vellum-ai/vellum-assistant · .claude/skills/add-mcp-integration/SKILL.md · Add a vendor's remote MCP server to the bundled integrations catalog (plugins/mcp-catalog/<name>/ +…
git:20260924.494829c · audit A · 1,467 stars
cli-testing SKILL.md skill
vellum-ai/vellum-assistant · .claude/skills/cli-testing/SKILL.md · Manually test a running Vellum assistant end-to-end purely from the CLI — no desktop app or web UI. Hatch an instance…
git:20260608.6985b64 · audit A · 1,467 stars
release SKILL.md skill
vellum-ai/vellum-assistant · .claude/skills/release/SKILL.md · Cut a new release: create the release branch (staging bake), then dispatch the production Release run on that branch.
git:20261001.80120c7 · audit A · 1,467 stars
update SKILL.md skill
vellum-ai/vellum-assistant · .claude/skills/update/SKILL.md · Restart the Vellum assistant and gateway services. Smart branch handling: pulls from main by default, restarts in-place…
git:20260616.1d51808 · audit A · 1,467 stars
e2e SKILL.md skill
vellum-ai/vellum-assistant · .claude/skills/vellum-skills/e2e/SKILL.md · Run end-to-end tests via the CI workflow.
git:20260317.23378c6 · audit A · 1,467 stars
vellum-boundary-guard SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-boundary-guard/SKILL.md · Check Vellum Assistant architecture and package boundaries. Use when editing imports, moving code, adding endpoints…
git:20260521.b4bdd7a · audit A · 1,467 stars
vellum-change-review SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-change-review/SKILL.md · Review Vellum Assistant code changes for correctness, repo-specific quality rules, security risks, and missing…
git:20260521.b4bdd7a · audit A · 1,467 stars
vellum-feature-flag-rollout SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-feature-flag-rollout/SKILL.md · Guide Vellum Assistant feature flag changes and rollout hygiene. Use when adding, editing, reviewing, or documenting…
git:20260612.4834458 · audit A · 1,467 stars
vellum-migration-checklist SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-migration-checklist/SKILL.md · Validate Vellum Assistant database and workspace migrations. Use when adding, editing, reviewing, or testing…
git:20260702.d65ff55 · audit A · 1,467 stars
vellum-pr-readiness SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-pr-readiness/SKILL.md · Prepare Vellum Assistant branches for review by checking git hygiene, PR scope, tests, docs, migrations, Linear…
git:20260521.b4bdd7a · audit A · 1,467 stars
vellum-skill-authoring SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-skill-authoring/SKILL.md · Author and review first-party Vellum skills in the repository. Use when editing files under skills/, assistant bundled…
git:20260521.b4bdd7a · audit A · 1,467 stars
vellum-test-selection SKILL.md skill
vellum-ai/vellum-assistant · .cursor/skills/vellum-test-selection/SKILL.md · Select focused verification commands for Vellum Assistant changes. Use when deciding what tests, typechecks, lints, or…
git:20260702.d65ff55 · audit A · 1,467 stars

Every file in vellum-ai/vellum-assistant

Other files named mcp-setup

mcp-setup SKILL.md skill
leadmagic/gtm-skills · skills/automation/mcp-setup/SKILL.md · Configure Model Context Protocol servers for GTM workflows — server selection, tool scope, permissions, guardrails…
v1.0.0 · audit A · 71 stars
mcp-setup SKILL.md skill
vargasjr-dev/mycadet-temp · skills/mcp-setup/SKILL.md · Add, authenticate, list, and remove MCP (Model Context Protocol) servers — connect any external tool or service that…
git:20261011.59db167 · audit A · 47 stars
mcp-setup SKILL.md skill
fmind/dot · skills/mcp-setup/SKILL.md · Add or fix MCP servers in coding agents and verify access.
git:20261031.ad68ebd · audit A · 12 stars
mcp-setup SKILL.md skill
naman10parikh/agentgrid · .claude/skills/mcp-setup/SKILL.md · Self-install MCP servers to expand Claude's capabilities. Read the catalog, install the server, wire it into .mcp.json…
git:20260526.f887f6c · audit A · 9 stars
mcp-setup SKILL.md skill
lawzava/megapowers · plugins/megapowers/skills/mcp-setup/SKILL.md · Use when installing, configuring, debugging, or verifying an MCP server for a harness, or when a configured server's…
git:20261101.662c2d5 · audit A · 8 stars
mcp-setup SKILL.md skill
naman10parikh/wikimem · .claude/skills/mcp-setup/SKILL.md · Self-install MCP servers to expand Claude's capabilities. Read the catalog, install the server, wire it into .mcp.json…
git:20260526.e594bbf · audit A · 7 stars

Browse by kind, by grade A, or by owner.