Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/davidpastorvicente/mcpx-cli/llms.txt

Use this file to discover all available pages before exploring further.

If you already have MCP servers configured in one of your AI tools, mcpx import reads that provider’s existing config file, parses the server definitions, and merges your selected servers into .agents/mcp.json. This is the quickest path to getting MCPX set up in a project that already has one or more provider configs — no manual copy-paste required. 
mcpx import [provider] [--dir <path>] [--verbose]

​
Arguments

ArgumentRequiredDescription
[provider]NoProvider ID to import from. If omitted, MCPX detects all present configs and shows an interactive picker.
Valid provider IDs: claude-code, antigravity-cli, kimi-cli, openai-codex, opencode, copilot-cli, vscode, intellij.

​
Import flow

1

Scan for existing configs

MCPX scans the target directory (and global paths, depending on scope) for all supported provider config files.
2

Show detected configurations

A summary is displayed listing each detected provider, the config file path, and the number of servers found inside it.
3

Select a provider

If [provider] was not specified on the command line, MCPX shows an interactive list of the detected providers. Select the one you want to import from.
4

Choose servers to import

MCPX parses the selected provider’s config and presents a multi-select list of all servers found. All servers are pre-selected; deselect any you want to skip.
5

Save to canonical config

The selected servers are written into .agents/mcp.json. If no canonical config exists yet, MCPX creates a minimal one before importing.
6

Optionally sync all providers

If the canonical config already has a providers array, MCPX offers to sync all provider files immediately. Confirming triggers the same sync logic as mcpx sync.

​
Examples

# Import directly from Claude Code — skips the provider picker
mcpx import claude-code

# Interactive provider selection — MCPX detects and lists available configs
mcpx import

​
Provider reference

Provider IDDisplay NameConfig file
claude-codeClaude Code.mcp.json
antigravity-cliAntigravity CLI.gemini/config/mcp_config.json
kimi-cliKimi CLI.kimi-code/mcp.json
openai-codexOpenAI Codex.codex/config.toml
opencodeOpenCodeopencode.json
copilot-cliCopilot CLI.copilot/mcp-config.json
vscodeVS Code.vscode/mcp.json
intellijIntelliJ IDEA.idea/mcp.json
If no .agents/mcp.json exists when you run mcpx import, MCPX automatically creates a minimal canonical config before writing the imported servers. You can then run mcpx init to select providers and generate their config files.
If a server name from the imported file already exists in .agents/mcp.json, the imported definition overwrites the existing entry. Review the multi-select step carefully if you have customized any servers locally since the last import.

Build docs developers (and LLMs) love

Get started for freeTalk to us