Agent skill

Maintaining Admin MCP

by speakeasy-api in speakeasy-api/gram

A skill your agent uses when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin…

AGPL-3.0Auto-check passedAgent Workflows

Install Maintaining Admin MCP

skills CLI
$ npx skills add speakeasy-api/gram --skill maintaining-admin-mcp -a claude-code

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

GitHub CLI
$ gh skill install speakeasy-api/gram maintaining-admin-mcp --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/speakeasy-api/gram.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/maintaining-admin-mcp .claude/skills/maintaining-admin-mcp && 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
maintaining-admin-mcp
GitHub stars
272
Token cost
~724 tokens
SKILL.md length
336 words
Files
1
Skills in repo
39
Repo updated
First seen
Licence
AGPL-3.0

At a glance

A skill your agent uses when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin…

  • Works in 7 steps: Describe the staff outcome and current… → Compare with existing Admin MCP tools.… → For additions or changes, keep typed… → …
  • Removing admin dashboard workflows
  • SKILL.md covers Assessment and Review checklist
  • Calls mise

What it does

Maintaining Admin MCP is an agent skill from speakeasy-api/gram. Use when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin, server/internal/admin, or server/internal/adminmcp. Assess staff Admin MCP parity and update its tools where applicable.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering MCP servers. It works with Model Context Protocol. The repository describes itself as: Securely scale AI usage across your organization. A single stack to Connect, Secure, Observe and Distribute agents, MCPs, and Skills within your company. The licence is AGPL-3.0.

When your agent uses it

  • Removing admin dashboard workflows
  • Backend admin APIs
  • Staff permissions
  • Staff-facing product capabilities in client/admin

Example prompts

  • “/maintaining-admin-mcp”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Describe the staff outcome and current dashboard behaviour. Identify the actor, target organisation/project, and evidence that the outcome…
  2. Compare with existing Admin MCP tools. Decide to update a tool, add an outcome-oriented tool, or omit MCP support. Record the decision and…
  3. For additions or changes, keep typed bounded inputs/outputs, descriptions, annotations, server instructions and focused tests in sync…
  4. Never expose secrets, broad SQL/HTTP proxies, cross-tenant identifiers as authority, or customer-supplied text as instructions. Reuse…
  5. For writes, require explicit canonical tenant/project targeting, a server-stored exact-change proposal, same-staff browser approval…
  6. Preserve live staff verification and admin:read/future admin:write scope enforcement at invocation. Tailnet-only route access must be…
  7. Validate with focused Admin MCP and affected admin tests via mise run test:server, plus server build/lint and Platform MCP regressions for…

What it can do on your machine

Read from SKILL.md and the folder at commit ad78247. 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

    Shell commands in SKILL.md call:

    • mise

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

  • Network

    No URLs in SKILL.md.

    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

Maintaining Admin MCP loads about 724 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 336 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~724

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from speakeasy-api/gram at commit ad78247, republished under its AGPL-3.0 licence (© speakeasy-api). 336 words, ~724 tokens.

Download SKILL.mdSave it as .claude/skills/maintaining-admin-mcp/SKILL.md (or your agent's skills folder).
name
maintaining-admin-mcp
description
Use when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin, server/internal/admin, or server/internal/adminmcp. Assess staff Admin MCP parity and update its tools where applicable.

Maintaining Staff Admin MCP

Staff Admin MCP is a staff-only surface in server/internal/adminmcp/. Use this skill when a dashboard/admin capability changes or when editing Admin MCP itself. Read the corresponding server/internal/admin/ service and client/admin/ workflow before deciding how to maintain parity.

Assessment

  1. Describe the staff outcome and current dashboard behaviour. Identify the actor, target organisation/project, and evidence that the outcome succeeded.
  2. Compare with existing Admin MCP tools. Decide to update a tool, add an outcome-oriented tool, or omit MCP support. Record the decision and reason in the change or PR review. A new dashboard button does not automatically warrant an MCP tool.
  3. For additions or changes, keep typed bounded inputs/outputs, descriptions, annotations, server instructions and focused tests in sync. Assess customer Platform MCP separately with maintaining-platform-mcp when applicable.
  4. Never expose secrets, broad SQL/HTTP proxies, cross-tenant identifiers as authority, or customer-supplied text as instructions. Reuse business service logic where it preserves existing safeguards, not customer principals or tenant-bound Platform MCP storage.
  5. For writes, require explicit canonical tenant/project targeting, a server-stored exact-change proposal, same-staff browser approval, transaction-time ownership/version checks, durable idempotency receipts and audit/privacy checks. Do not add a write tool when any boundary is unavailable.
  6. Preserve live staff verification and admin:read/future admin:write scope enforcement at invocation. Tailnet-only route access must be verified separately; tool discovery is not an authorization boundary.
  7. Validate with focused Admin MCP and affected admin tests via mise run test:server, plus server build/lint and Platform MCP regressions for shared changes. When dashboard UI changes, run its existing checks. Document unavailable infrastructure instead of claiming end-to-end parity.

Review checklist

  • Is the dashboard outcome represented accurately in Admin MCP, or was an explicit update/add/omit decision recorded?
  • Are exact targets, live staff authorisation, bounded results and secret omissions preserved?
  • Do tool metadata and tests reflect the new behaviour, including errors and unavailable dependencies?
  • For writes, are cross-tenant mismatch, approval replay, audit masking and concurrent execution covered?
  • Does the change leave customer Platform MCP and managed assistants unaffected unless separately intended?

© speakeasy-api, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/maintaining-admin-mcp of speakeasy-api/gram.

Open the folder on GitHubat commit ad78247

Compare with similar skills

Maintaining Admin MCP 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.

Maintaining Admin MCP compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maintaining Admin MCP this skillspeakeasy-api/gram272—~724Automated safety check: PassAGPL-3.0
MCP Server Builderanthropics/skills180k64 repos~2.3kAutomated safety check: PassApache-2.0
MCP Server BuildershareAI-lab/learn-claude-code78k5 repos~1.2kAutomated safety check: PassMIT
MCP Integration for Pluginsanthropics/claude-plugins-official38k11 repos~3.1kAutomated safety check: PassApache-2.0
Fastmcp Client CLIPrefectHQ/fastmcp28k1 repos~823Automated safety check: PassApache-2.0
Crush Configurationcharmbracelet/crush29k—~3.7kAutomated safety check: PassCustom licence

Similar skills

  • 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 64 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
  • MCP Integration for Plugins

    anthropics/claude-plugins-official

    Official

    Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.

    38k GitHub starsUsed in 11 repos~3.1k tokens
    Agent WorkflowsAuto-check passed
  • Fastmcp Client CLI

    PrefectHQ/fastmcp

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

    28k GitHub starsUsed in 1 repo~823 tokens
    Agent WorkflowsAuto-check passed
  • Crush Configuration

    charmbracelet/crush

    Explains how to configure the Crush coding agent with crushrc or crush.json, covering providers, models, LSPs, MCP servers, hooks, permissions and config precedence.

    29k GitHub stars~3.7k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Context Mode Output Sandbox

    mksglu/context-mode

    Routes large command, file, API and browser output through context-mode tools so only the needed result enters the agent's context, instead of dumping it via Bash.

    26k GitHub stars~4.1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from speakeasy-api/gram

All 39 skills in this repo
  • Gram Playwright CLI

    speakeasy-api/gram

    A skill your agent uses when automating the Gram dashboard in a browser, capturing screenshots, inspecting pages.

    272 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Transactional Email

    speakeasy-api/gram

    A skill your agent uses when adding, changing, restyling, reviewing, validating, or previewing a Gram/Speakeasy transactional email, in Go or in LMX/MJML — a template<name.go, a TemplateKey…

    272 GitHub stars~4.7k tokensUpdated today
    Auto-check passed
  • Admin Shadcn

    speakeasy-api/gram

    A skill your agent uses when adding, changing, or styling UI in client/admin (the Gram admin dashboard) that touches shadcn/ui — a button, dialog, table, sidebar, badge, select, tabs, tooltip, card…

    272 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • A skill your agent uses when adding, editing, reviewing, testing, or locating a reviewed skill distributed with the Platform MCP plugin; triggers include "Platform MCP skill", "platformmcpskills"…

    272 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Clickhouse

    speakeasy-api/gram

    A skill your agent uses when changing or reviewing Gram ClickHouse schemas, migrations, queries, inserts, access principals, bootstrap SQL, Cloud compatibility, partial migration failures, or…

    272 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • Feature Flag

    speakeasy-api/gram

    A skill your agent uses when gating a feature behind a flag, dogfooding or gradually rolling out a change, choosing between productfeatures and PostHog feature flags, adding or checking a product…

    272 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Categories

Questions about Maintaining Admin MCP

What does Maintaining Admin MCP do?

A skill your agent uses when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin…. Maintaining Admin MCP is an agent skill from speakeasy-api/gram. Use when adding, changing, or removing admin dashboard workflows, backend admin APIs, staff permissions, or staff-facing product capabilities in client/admin, server/internal/admin, or server/internal/adminmcp.

When should I use Maintaining Admin MCP?

Maintaining Admin MCP fits situations like: removing admin dashboard workflows; backend admin APIs; staff permissions; staff-facing product capabilities in client/admin.

How do I install Maintaining Admin MCP in Claude Code?

Run `npx skills add speakeasy-api/gram --skill maintaining-admin-mcp -a claude-code`. Or copy the skill folder (.agents/skills/maintaining-admin-mcp in speakeasy-api/gram) into .claude/skills/maintaining-admin-mcp in your project. Claude Code loads it when a task matches its description.

How do I install Maintaining Admin MCP in Codex?

Run `npx skills add speakeasy-api/gram --skill maintaining-admin-mcp -a codex`. Or copy the skill folder (.agents/skills/maintaining-admin-mcp in speakeasy-api/gram) into .agents/skills/maintaining-admin-mcp in your project. Codex loads it when a task matches its description.

Can I use Maintaining Admin MCP 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 speakeasy-api/gram --skill maintaining-admin-mcp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maintaining-admin-mcp, .gemini/skills/maintaining-admin-mcp, .github/skills/maintaining-admin-mcp and .opencode/skills/maintaining-admin-mcp in your project.

What does Maintaining Admin MCP need to run?

Going by SKILL.md and its folder, Maintaining Admin MCP needs the command-line tools its instructions call (mise).

Does Maintaining Admin MCP access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Maintaining Admin MCP 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. Review the folder before installing.

What licence does Maintaining Admin MCP use?

Maintaining Admin MCP is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Maintaining Admin MCP use?

About 724 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Maintaining Admin MCP?

Skills that share tags, products or a category with Maintaining Admin MCP: MCP Server Builder (anthropics/skills, 180k stars), MCP Server Builder (shareAI-lab/learn-claude-code, 78k stars), MCP Integration for Plugins (anthropics/claude-plugins-official, 38k stars) and Fastmcp Client CLI (PrefectHQ/fastmcp, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maintaining Admin MCP?

speakeasy-api (a GitHub organization) maintains it in speakeasy-api/gram, which has 272 GitHub stars. The repository holds 39 skills in this directory. The repository was last updated on October 8, 2026.

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