ai-mcp SKILL.md skillA

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

Install it, pinned
mdr add tanstack/ai/ai-mcp@git:20261022.39c1c79

Pins git:20261022.39c1c79 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
tanstack/ai
Path
packages/ai-mcp/skills/ai-mcp/SKILL.md
Versions recorded
19
Latest version
git:20261022.39c1c79, committed Oct 22, 2026
First version recorded
Jun 5, 2026
Size
54,696 bytes
Repository stars
3,337
License
MIT

Host-side Model Context Protocol (MCP) for TanStack AI: connect to external MCP servers, host your own tools with createMCPServer, discover and run tools inside any adapter's chat() loop, read resources and prompts, generate TypeScript types (typed tool names/pool keys) with the bundled CLI, and manage lifecycle with close()/await using.

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

# `@tanstack/ai-mcp`

This skill covers the `@tanstack/ai-mcp` package. Read `ai-core/tool-calling/SKILL.md`
first — MCP tools flow into `chat()` the same way hand-written tools do.
If you host the tools yourself, use `createMCPServer`.

## When to use this package

Use `@tanstack/ai-mcp` when:

- A third-party MCP server exposes tools you want an agent or chat loop to call.
- You want to read MCP server resources (files, text, data) or prompts into a
  `chat()` message list.
- You want generated TypeScript types for an external MCP server's tool
  signatures (via the bundled `generate` CLI).
- You are running tool execution on the server side and want to connect to MCP
  servers with HTTP (Streamable HTTP or SSE) or stdio transports.
- You want to expose your own tools as an MCP server over HTTP or stdio.

Do NOT use this package for browser/client-side code — MCP connections are
server-side only.

## Install

```bash
pnpm add @tanstack/ai-mcp
```

The package has these subpaths:

- `.` exports `createMCPClient`, `createMCPClients`, converters, and types.
- `./stdio` exports the Node-only client transport `stdioTransport`.
- `./server` exports `createMCPServer`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add tanstack/ai/ai-mcp@sha256:ede11c6411de4a53

The line at the top of this page pins the label git:20261022.39c1c79, 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_j2naup5kty3mxbkn.svg)](https://markdownregistry.com/a/art_j2naup5kty3mxbkn)

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

Versions

The registry has recorded 19 versions of this file, between Jun 5, 2026 and Oct 22, 2026, about one every 8 days.

versioncommittedcommitsizeaudit
git:20261022.39c1c79 latest2026-10-22 39c1c79 54,696 BA view · diff
git:20261022.3e846062026-10-22 3e84606 52,005 BA view · diff
git:20261022.f1b3f652026-10-22 f1b3f65 49,691 BA view · diff
git:20261022.52cb02d2026-10-22 52cb02d 49,340 BA view · diff
git:20261022.a99204a2026-10-22 a99204a 48,992 BA view · diff
git:20261022.e3b28852026-10-22 e3b2885 48,806 BA view · diff
git:20261013.dce9fbe2026-10-13 dce9fbe 48,272 BA view · diff
git:20261013.fac05552026-10-13 fac0555 46,084 BA view · diff
git:20261006.fb29a062026-10-06 fb29a06 46,018 BA view · diff
git:20261006.cda5bc52026-10-06 cda5bc5 45,873 BA view · diff
git:20261002.ee726f52026-10-02 ee726f5 45,658 BA view · diff
git:20260927.0eb8f0b2026-09-27 0eb8f0b 44,472 BA view · diff
git:20260925.4e306252026-09-25 4e30625 33,602 BA view · diff
git:20260925.784feb32026-09-25 784feb3 33,434 BA view · diff
git:20260917.c5e4cd02026-09-17 c5e4cd0 32,224 BA view · diff
git:20260909.53e2ec02026-09-09 53e2ec0 32,086 BA view · diff
git:20260804.d9d1e1f2026-08-04 d9d1e1f 28,873 BA view · diff
git:20260626.c1a87322026-06-26 c1a8732 28,874 BA view · diff
git:20260605.496e8142026-06-05 496e814 22,490 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 (54696 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

tanstack/ai · 3,337 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_j2naup5kty3mxbkn
GET https://markdownregistry.com/api/v1/resolve?ref=tanstack/ai/ai-mcp
GET https://markdownregistry.com/api/v1/blob/ede11c6411de4a532fb4243c976af8a15c6b7fca79e0c15529b96e486ca32a72

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 tanstack/ai

add-example-tutorial SKILL.md skill
tanstack/ai · .agents/skills/add-example-tutorial/SKILL.md · Use when adding a public teaching example or a docs tutorial. Don't use for an internal Nx playground (that is…
git:20261022.f1b3f65 · audit A · 3,337 stars
bugfix-pr SKILL.md skill
tanstack/ai · .agents/skills/bugfix-pr/SKILL.md · Treats bug-fix pull requests as invasive and untrusted. The agent must security-scan the PR first, must not run any…
git:20260831.cdefc64 · audit A · 3,337 stars
docs SKILL.md skill
tanstack/ai · .agents/skills/docs/SKILL.md · Use when writing, editing, or organizing documentation, when planning what docs a feature needs, and whenever planning…
git:20261022.f1b3f65 · audit A · 3,337 stars
gap-analysis SKILL.md skill
tanstack/ai · .agents/skills/gap-analysis/SKILL.md · Audit TanStack AI provider adapters for feature parity gaps and outdated model lists. Triggered as /gap-analysis…
git:20260824.c1c0dc0 · audit A · 3,337 stars
i-have-adhd SKILL.md skill
tanstack/ai · .agents/skills/i-have-adhd/SKILL.md · Use when the user invokes /i-have-adhd, says they have ADHD, or asks for ADHD-friendly output. Also used as a required…
git:20260824.c1c0dc0 · audit A · 3,337 stars
new-react-playground SKILL.md skill
tanstack/ai · .agents/skills/new-react-playground/SKILL.md · Use when an agent in this TanStack AI monorepo needs a playground app to try a new feature. Trigger: new feature to try…
git:20260917.62ba217 · audit A · 3,337 stars
ponytail SKILL.md skill
tanstack/ai · .agents/skills/ponytail/SKILL.md · Forces the laziest solution that actually works, simplest, shortest, most minimal. Channels a senior dev who has seen…
git:20260820.9ac4a38 · audit A · 3,337 stars
pr-description SKILL.md skill
tanstack/ai · .agents/skills/pr-description/SKILL.md · Use when writing a pull request title or body, when about to run gh pr create, when about to git push on a branch that…
git:20260824.81c40c1 · audit A · 3,337 stars
pr-sweep SKILL.md skill
tanstack/ai · .agents/skills/pr-sweep/SKILL.md · Sweep open (or listed) PRs with up to 100 parallel agents: security-scan outside contributors, rebase onto main when…
git:20260831.cdefc64 · audit A · 3,337 stars
simple-english SKILL.md skill
tanstack/ai · .agents/skills/simple-english/SKILL.md · Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous…
v1.0.0 · audit A · 3,337 stars
triage-github SKILL.md skill
tanstack/ai · .agents/skills/triage-github/SKILL.md · Triage all open GitHub issues, PRs, and discussions in the current repository by fanning out up to 100 parallel…
git:20260824.c1c0dc0 · audit A · 3,337 stars
add-example-tutorial SKILL.md skill
tanstack/ai · .claude/skills/add-example-tutorial/SKILL.md · Use when adding a public teaching example or a docs tutorial. Don't use for an internal Nx playground (that is…
git:20261022.f1b3f65 · audit A · 3,337 stars

Every file in tanstack/ai

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