# Mcporter MCP First

> Use this skill when a task needs MCP tools, internal app connectors, or "use mcp" behavior. Search and inspect mcporter servers/tools first, then call the right MCP tool through mcporter before using browser, REST, raw CLI, or other fallback paths.

- Skill: `zereight/mcporter-mcp-first` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add zereight/mcporter-mcp-first`
- Raw SKILL.md: https://api.skillmd.com/api/skills/zereight/mcporter-mcp-first/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: zereight (https://skillmd.com/u/zereight)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/zereight/mcporter-mcp-first

---


# Mcporter MCP First

## Overview

When a task needs MCP, treat `mcporter` as the first registry to inspect. It knows the locally configured MCP servers and can expose tools that are not already loaded in the Codex tool list.

## Trigger

Use this skill when the user asks to:

- use MCP, `mcporter`, or a named internal connector
- read internal systems where a local MCP server likely exists
- inspect PRs, issues, docs, browser targets, design files, or app data through MCP
- recover from missing direct MCP namespaces by searching local mcporter servers
- avoid REST/browser/raw git when a configured MCP server is the intended source

## Workflow

1. Discover mcporter tools first.
   - Use `tool_search` for `mcporter <domain keywords>` if `mcp__mcporter_bridge__` is not already loaded.
   - Prefer `mcp__mcporter_bridge__` tools when available:
     - `mcporter_list_servers`
     - `mcporter_help`
     - `mcporter_inspect_server`
     - `mcporter_call_tool`
   - If the bridge transport fails, use the local CLI:
     `/Users/tao.exe/.nvm/versions/node/v22.22.2/bin/mcporter`

2. Narrow to the relevant server before listing schemas.
   - Avoid broad `mcporter list` if possible; it can hang on unrelated servers.
   - Prefer `mcporter list <server> --schema --json`.
   - If the server name is unknown, use `mcporter_list_servers` with a timeout, then inspect the likely server only.

3. Inspect the tool parameter format before calling it.
   - Use `mcporter_help(server=<server>)` to list tools.
   - Use `mcporter_help(server=<server>, tool=<tool>)` or `mcporter_inspect_server` for schemas.
   - With `mcporter_call_tool`, pass `arguments` as a JSON object, not a string.

4. Call the MCP tool before fallback paths.
   - Prefer mcporter MCP output over direct REST, browser scraping, or raw git when the user requested MCP or the task targets an internal system.
   - If mcporter fails, record the exact failure and then use the narrowest fallback.

## Examples

### Bitbucket PR

Use server `bitbucket`.

**Fast path for PR review:**

1. PR metadata + diff:
   `bb_get_pr(workspaceSlug=bank-x, repoSlug=mobile-app-workspace, prId=<ID>, includeFullDiff=true)`
2. Comments:
   `bb_ls_pr_comments(workspaceSlug=bank-x, repoSlug=mobile-app-workspace, prId=<ID>)`
3. Branch diff (alternate):
   `bb_diff_branches(workspaceSlug=bank-x, repoSlug=mobile-app-workspace, sourceBranch=<src>, destinationBranch=<dst>)`
4. Source files:
   `bb_get_file(workspaceSlug=bank-x, repoSlug=mobile-app-workspace, filePath=<path>, revision=<commit>)`

BankX common identifiers:
- `workspaceSlug=bank-x`
- `repoSlug=mobile-app-workspace`
- `prId` is a string, not integer

When git diff is unavailable (review mode), prefer mcporter for all reads.
Only fall back to git after mcporter failure.

### Atlassian Docs

Use the configured Atlassian server if available. Inspect schema first; do not guess page parameters.

### Browser/DevTools MCP

If the user asks to inspect a local browser target through MCP, search mcporter for browser/devtools servers before shell or external browser fallback.

## Known Failure Modes

- `mcporter list` without a server can hang on unrelated MCP servers. Prefer server-specific list/inspect.
- Some MCP servers write logs/cache under home directories; sandboxed calls can fail with `EPERM`. If the MCP call is necessary, rerun the exact mcporter command with escalation.
- Bridge transport can close while CLI still works. Fall back to the mcporter CLI before abandoning MCP.
- Do not use unauthenticated REST before mcporter for internal resources.

## Output Expectations

State whether the answer came from mcporter MCP or a fallback. For Korean internal engineering requests, answer in Korean and include exact server/tool names used when useful.