New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Fastmcp

by Tommy-yw in Tommy-yw/RunbookHermes

Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

MITAuto-check passedAgent Workflows

Install Fastmcp

skills CLI
$ npx skills add Tommy-yw/RunbookHermes --skill fastmcp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Tommy-yw/RunbookHermes fastmcp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Tommy-yw/RunbookHermes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/optional-skills/mcp/fastmcp .claude/skills/fastmcp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fastmcp
GitHub stars
546
Used in
3 other repos
Token cost
~2.1k tokens
SKILL.md length
907 words
Files
6 (incl. scripts, references)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

  • Works in 7 steps: Pick the Smallest Viable Server Shape → Scaffold from a Template → Implement Tools First → …
  • Creating a new MCP server
  • SKILL.md covers When to Use, Prerequisites, Included Files and Workflow, plus 4 more sections
  • Runs Python scripts from its folder; calls pip and python

What it does

Fastmcp is an agent skill from Tommy-yw/RunbookHermes. Build, test, inspect, install, and deploy MCP servers with FastMCP in Python. Use when creating a new MCP server, wrapping an API or database as MCP tools, exposing resources or prompts, or preparing a FastMCP server for Claude Code, Cursor, or HTTP deployment.

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `references/fastmcp-cli.md`, `scripts/scaffold_fastmcp.py` and `templates/api_wrapper.py`).

It sits in Agent Workflows, covering MCP servers and Deployment. It works with Model Context Protocol and Python. The repository describes itself as: Hermes-native AIOps agent for evidence-driven incident response, approval-gated remediation, and runbook learning. The licence is MIT.

When your agent uses it

  • Creating a new MCP server
  • Wrapping an API
  • Database as MCP tools
  • Exposing resources

Example prompts

  • “/fastmcp”

Requirements

  • Python 3

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Pick the Smallest Viable Server Shape
  2. Scaffold from a Template
  3. Implement Tools First
  4. Add Resources and Prompts Only When They Help
  5. Test the Server Before Integrating It Anywhere
  6. Install into a Client When Local Validation Passes
  7. Deploy After the Local Contract Is Stable

What it can do on your machine

Read from SKILL.md and the folder at commit 7fd2b9a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • pip
    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fastmcp loads about 2.1k tokens when it runs, and up to ~2.7k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 907 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Tommy-yw/RunbookHermes at commit 7fd2b9a, republished under its MIT licence (© Tommy-yw). 907 words, ~2,084 tokens.

Download SKILL.mdSave it as .claude/skills/fastmcp/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
fastmcp
description
Build, test, inspect, install, and deploy MCP servers with FastMCP in Python. Use when creating a new MCP server, wrapping an API or database as MCP tools, exposing resources or prompts, or preparing a FastMCP server for Claude Code, Cursor, or HTTP deployment.
version
1.0.0
author
Hermes Agent
license
MIT
prerequisites.commands
python3

FastMCP

Build MCP servers in Python with FastMCP, validate them locally, install them into MCP clients, and deploy them as HTTP endpoints.

When to Use

Use this skill when the task is to:

  • create a new MCP server in Python
  • wrap an API, database, CLI, or file-processing workflow as MCP tools
  • expose resources or prompts in addition to tools
  • smoke-test a server with the FastMCP CLI before wiring it into Hermes or another client
  • install a server into Claude Code, Claude Desktop, Cursor, or a similar MCP client
  • prepare a FastMCP server repo for HTTP deployment

Use native-mcp when the server already exists and only needs to be connected to Hermes. Use mcporter when the goal is ad-hoc CLI access to an existing MCP server instead of building one.

Prerequisites

Install FastMCP in the working environment first:

bash
pip install fastmcp
fastmcp version

For the API template, install httpx if it is not already present:

bash
pip install httpx

Included Files

Templates
  • templates/api_wrapper.py - REST API wrapper with auth header support
  • templates/database_server.py - read-only SQLite query server
  • templates/file_processor.py - text-file inspection and search server
Scripts
  • scripts/scaffold_fastmcp.py - copy a starter template and replace the server name placeholder
References
  • references/fastmcp-cli.md - FastMCP CLI workflow, installation targets, and deployment checks

Workflow

1. Pick the Smallest Viable Server Shape

Choose the narrowest useful surface area first:

  • API wrapper: start with 1-3 high-value endpoints, not the whole API
  • database server: expose read-only introspection and a constrained query path
  • file processor: expose deterministic operations with explicit path arguments
  • prompts/resources: add only when the client needs reusable prompt templates or discoverable documents

Prefer a thin server with good names, docstrings, and schemas over a large server with vague tools.

2. Scaffold from a Template

Copy a template directly or use the scaffold helper:

bash
python ~/.hermes/skills/mcp/fastmcp/scripts/scaffold_fastmcp.py \
  --template api_wrapper \
  --name "Acme API" \
  --output ./acme_server.py

Available templates:

bash
python ~/.hermes/skills/mcp/fastmcp/scripts/scaffold_fastmcp.py --list

If copying manually, replace __SERVER_NAME__ with a real server name.

3. Implement Tools First

Start with @mcp.tool functions before adding resources or prompts.

Rules for tool design:

  • Give every tool a concrete verb-based name
  • Write docstrings as user-facing tool descriptions
  • Keep parameters explicit and typed
  • Return structured JSON-safe data where possible
  • Validate unsafe inputs early
  • Prefer read-only behavior by default for first versions

Good tool examples:

  • get_customer
  • search_tickets
  • describe_table
  • summarize_text_file

Weak tool examples:

  • run
  • process
  • do_thing
4. Add Resources and Prompts Only When They Help

Add @mcp.resource when the client benefits from fetching stable read-only content such as schemas, policy docs, or generated reports.

Add @mcp.prompt when the server should provide a reusable prompt template for a known workflow.

Do not turn every document into a prompt. Prefer:

  • tools for actions
  • resources for data/document retrieval
  • prompts for reusable LLM instructions
5. Test the Server Before Integrating It Anywhere

Use the FastMCP CLI for local validation:

bash
fastmcp inspect acme_server.py:mcp
fastmcp list acme_server.py --json
fastmcp call acme_server.py search_resources query=router limit=5 --json

For fast iterative debugging, run the server locally:

bash
fastmcp run acme_server.py:mcp

To test HTTP transport locally:

bash
fastmcp run acme_server.py:mcp --transport http --host 127.0.0.1 --port 8000
fastmcp list http://127.0.0.1:8000/mcp --json
fastmcp call http://127.0.0.1:8000/mcp search_resources query=router --json

Always run at least one real fastmcp call against each new tool before claiming the server works.

6. Install into a Client When Local Validation Passes

FastMCP can register the server with supported MCP clients:

bash
fastmcp install claude-code acme_server.py
fastmcp install claude-desktop acme_server.py
fastmcp install cursor acme_server.py -e .

Use fastmcp discover to inspect named MCP servers already configured on the machine.

When the goal is Hermes integration, either:

  • configure the server in ~/.hermes/config.yaml using the native-mcp skill, or
  • keep using FastMCP CLI commands during development until the interface stabilizes
Show full SKILL.md (379 more words)Show less
7. Deploy After the Local Contract Is Stable

For managed hosting, Prefect Horizon is the path FastMCP documents most directly. Before deployment:

bash
fastmcp inspect acme_server.py:mcp

Make sure the repo contains:

  • a Python file with the FastMCP server object
  • requirements.txt or pyproject.toml
  • any environment-variable documentation needed for deployment

For generic HTTP hosting, validate the HTTP transport locally first, then deploy on any Python-compatible platform that can expose the server port.

Common Patterns

API Wrapper Pattern

Use when exposing a REST or HTTP API as MCP tools.

Recommended first slice:

  • one read path
  • one list/search path
  • optional health check

Implementation notes:

  • keep auth in environment variables, not hardcoded
  • centralize request logic in one helper
  • surface API errors with concise context
  • normalize inconsistent upstream payloads before returning them

Start from templates/api_wrapper.py.

Database Pattern

Use when exposing safe query and inspection capabilities.

Recommended first slice:

  • list_tables
  • describe_table
  • one constrained read query tool

Implementation notes:

  • default to read-only DB access
  • reject non-SELECT SQL in early versions
  • limit row counts
  • return rows plus column names

Start from templates/database_server.py.

File Processor Pattern

Use when the server needs to inspect or transform files on demand.

Recommended first slice:

  • summarize file contents
  • search within files
  • extract deterministic metadata

Implementation notes:

  • accept explicit file paths
  • check for missing files and encoding failures
  • cap previews and result counts
  • avoid shelling out unless a specific external tool is required

Start from templates/file_processor.py.

Quality Bar

Before handing off a FastMCP server, verify all of the following:

  • server imports cleanly
  • fastmcp inspect <file.py:mcp> succeeds
  • fastmcp list <server spec> --json succeeds
  • every new tool has at least one real fastmcp call
  • environment variables are documented
  • the tool surface is small enough to understand without guesswork

Troubleshooting

FastMCP command missing

Install the package in the active environment:

bash
pip install fastmcp
fastmcp version
fastmcp inspect fails

Check that:

  • the file imports without side effects that crash
  • the FastMCP instance is named correctly in <file.py:object>
  • optional dependencies from the template are installed
Tool works in Python but not through CLI

Run:

bash
fastmcp list server.py --json
fastmcp call server.py your_tool_name --json

This usually exposes naming mismatches, missing required arguments, or non-serializable return values.

Hermes cannot see the deployed server

The server-building part may be correct while the Hermes config is not. Load the native-mcp skill and configure the server in ~/.hermes/config.yaml, then restart Hermes.

References

For CLI details, install targets, and deployment checks, read references/fastmcp-cli.md.

© Tommy-yw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in optional-skills/mcp/fastmcp of Tommy-yw/RunbookHermes.

  • SKILL.md
  • references/fastmcp-cli.md
  • scripts/scaffold_fastmcp.py
  • templates/api_wrapper.py
  • templates/database_server.py
  • templates/file_processor.py

Open the folder on GitHubat commit 7fd2b9a

Used in 3 other repositories

We found 3 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 3 other GitHub owners. This page covers the copy in Tommy-yw/RunbookHermes, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Fastmcp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fastmcp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fastmcp this skillTommy-yw/RunbookHermes5463 repos~2.1kAutomated safety check: PassMIT
MCP Builderjezweb/claude-skills1.1k—~3.1kAutomated safety check: NotesMIT
AWS Cdk Developmentzxkane/aws-skills3672 repos~2.5kAutomated safety check: PassMIT
MCP Server Builderanthropics/skills180k63 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MemPalace Setup and OperationMemPalace/mempalace59k—~2.2kAutomated safety check: PassMIT

Similar skills

  • MCP Builder

    jezweb/claude-skills

    Build MCP servers in Python with FastMCP. An agent skill from jezweb/claude-skills.

    1.1k GitHub stars~3.1k tokensUpdated 4 days ago
    Agent WorkflowsAuto-check: notes

  • AWS Cdk Development

    zxkane/aws-skills

    AWS Cloud Development Kit (CDK) expert for building cloud infrastructure with TypeScript/Python.

    367 GitHub starsUsed in 2 repos~2.5k tokens
    DevOps & CloudAuto-check passed

  • MCP Server Builder

    anthropics/skills

    Official

    Guides the design and implementation of Model Context Protocol servers in TypeScript or Python, from tool naming and error messages to evaluation.

    180k GitHub starsUsed in 63 repos~2.3k tokens
    Agent WorkflowsAuto-check passed

  • MCP Server Builder

    shareAI-lab/learn-claude-code

    Walks through building MCP servers in Python or TypeScript that expose tools, resources and prompts to Claude, with templates, registration and testing.

    78k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed

  • MemPalace Setup and Operation

    MemPalace/mempalace

    Installs and configures MemPalace as a private local palace, a shared-brain hub or a client of an existing hub, including MCP registration and version-correct initialization.

    59k GitHub stars~2.2k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

  • Fastmcp Client CLI

    PrefectHQ/fastmcp

    Query and invoke tools on MCP servers using fastmcp list and fastmcp call.

    28k GitHub stars~823 tokensUpdated today
    Agent WorkflowsAuto-check passed

More from Tommy-yw/RunbookHermes

All 38 skills in this repo

  • Drug Discovery

    Tommy-yw/RunbookHermes

    Pharmaceutical research assistant for drug discovery workflows.

    546 GitHub starsUsed in 1 repo~2.3k tokens
    Auto-check passed

  • Youtube Content

    Tommy-yw/RunbookHermes

    Fetch YouTube video transcripts and transform them into structured content (chapters, summaries, threads, blog posts).

    546 GitHub starsUsed in 1 repo~785 tokens
    Auto-check passed

  • Oss Forensics

    Tommy-yw/RunbookHermes

    Supply chain investigation, evidence recovery, and forensic analysis for GitHub repositories.

    546 GitHub starsUsed in 3 repos~5k tokens
    Auto-check passed

  • P5js

    Tommy-yw/RunbookHermes

    Production pipeline for interactive and generative visual art using p5.js.

    546 GitHub starsUsed in 1 repo~6.8k tokens
    Auto-check passed

  • Touchdesigner MCP

    Tommy-yw/RunbookHermes

    Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals.

    546 GitHub starsUsed in 2 repos~3.4k tokens
    Auto-check passed

  • 1password

    Tommy-yw/RunbookHermes

    Set up and use 1Password CLI (op). An agent skill from Tommy-yw/RunbookHermes.

    546 GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check: notes

Works with

Categories

Questions about Fastmcp

What does Fastmcp do?

Build, test, inspect, install, and deploy MCP servers with FastMCP in Python. Fastmcp is an agent skill from Tommy-yw/RunbookHermes. Build, test, inspect, install, and deploy MCP servers with FastMCP in Python.

When should I use Fastmcp?

Fastmcp fits situations like: creating a new MCP server; wrapping an API; database as MCP tools; exposing resources.

How do I install Fastmcp in Claude Code?

Run `npx skills add Tommy-yw/RunbookHermes --skill fastmcp -a claude-code`. Or copy the skill folder (optional-skills/mcp/fastmcp in Tommy-yw/RunbookHermes) into .claude/skills/fastmcp in your project. Claude Code loads it when a task matches its description.

How do I install Fastmcp in Codex?

Run `npx skills add Tommy-yw/RunbookHermes --skill fastmcp -a codex`. Or copy the skill folder (optional-skills/mcp/fastmcp in Tommy-yw/RunbookHermes) into .agents/skills/fastmcp in your project. Codex loads it when a task matches its description.

Can I use Fastmcp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Tommy-yw/RunbookHermes --skill fastmcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fastmcp, .gemini/skills/fastmcp, .github/skills/fastmcp and .opencode/skills/fastmcp in your project.

What does Fastmcp need to run?

Going by SKILL.md and its folder, Fastmcp needs Python for the scripts in its folder and the command-line tools its instructions call (pip and python). Our summary lists: Python 3.

Does Fastmcp access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Fastmcp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Fastmcp use?

Fastmcp is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fastmcp use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 590 tokens, read only when the agent opens those files.

What are the alternatives to Fastmcp?

Skills that share tags, products or a category with Fastmcp: MCP Builder (jezweb/claude-skills, 1.1k stars), AWS Cdk Development (zxkane/aws-skills, 367 stars), MCP Server Builder (anthropics/skills, 180k stars) and MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fastmcp?

Tommy-yw (a GitHub user) maintains it in Tommy-yw/RunbookHermes, which has 546 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on May 18, 2026.

Source: Tommy-yw/RunbookHermes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.