skills.rest
pulsemcp
pulsemcpOFFICIAL
Explore all skills by this author →
Website𝕏@pulsemcpGitHub

adjust-claude-mcp-json

Convert flat mcp.json entries into Claude Code's mcpServers structure.

1|Updated Feb 5, 2026
Search Tags:#merge#constraints#update#claude-code#generate#server-config#mcp.json
One-click install
npx skills add https://github.com/pulsemcp/agentic-engineering --skill adjust-claude-mcp-json
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: adjust-claude-mcp-json
Source: https://github.com/pulsemcp/agentic-engineering/tree/main/.claude/skills/adjust-claude-mcp-json
Command: npx skills add https://github.com/pulsemcp/agentic-engineering --skill adjust-claude-mcp-json

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Generate or update a Claude Code .mcp.json file from the project's mcp-servers/mcp.json, enabling Claude Code to use a trusted, project-wide server configuration.

Core Features & Use Cases

  • Transform the flat mcp.json entries into Claude Code's expected mcpServers format.
  • Merge new entries into an existing .mcp.json or create one when missing.
  • Apply user-provided constraints (e.g., read-only, minimal) during the transformation.

Quick Start

Execute the skill with your desired server set (e.g., all) to generate or update the project root .mcp.json from mcp-servers/mcp.json.

Frequently Asked Questions about adjust-claude-mcp-json

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Claude Code .mcp.json file from my project's mcp.json?▼

To generate a .mcp.json file, this Skill translates your project's flat mcp.json entries into Claude Code's expected mcpServers structure. It creates a new .mcp.json at your project root when one does not already exist, applying your specified server constraints.

What happens if I already have a .mcp.json file and want to update it?▼

When updating an existing .mcp.json file, the Skill merges new server entries from your mcp-servers/mcp.json into it. It preserves your existing configurations unless they are explicitly overwritten by your new input.

Can I apply read-only or minimal access constraints when configuring Claude Code servers?▼

Yes, you can apply user-provided constraints such as read-only or minimal access settings. The Skill respects these scope limitations during the transformation process to restrict environment or access permissions in the generated .mcp.json.

Does Claude Code use a different mcp.json format than my project's flat server config?▼

Yes, Claude Code uses a specific mcpServers structure rather than a flat configuration. This Skill transforms your flat mcp.json entries into that expected nested format to ensure Claude Code correctly recognizes and loads the trusted servers.

What's the best way to sync a trusted project-wide server configuration into Claude Code?▼

The best way to sync a trusted configuration is to use this Skill to translate your mcp-servers/mcp.json into Claude Code's .mcp.json format. This ensures Claude Code uses your project-wide server configuration with all constraints applied.

Related Skills

Explore More Software Engineering Skills→
SafphereSafphere
335

MCP Manager

Configure MCP servers by editing mcp.json for Claude Agent SDK standards.

Official
Intermediate
ecielamecielam

MCP Integration

Configure MCP servers as tools in Claude Code plugins via .mcp.json.

Community
Advanced
robertphyattrobertphyatt
7

activate-professional-mode

Enforce human-approved workflow gates in Claude Code sessions.

Community
Advanced
outfitter-devoutfitter-dev
28

codex-configuration

Configure Codex CLI config.toml sections, profiles, MCP servers, and approval policies.

Official
Advanced