mcpc-mcp-client

Connects to MCP servers from the command line with persistent sessions, OAuth, and JSON output.

7|2|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/mcp-skills --skill mcpc-mcp-client-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mcpc-mcp-client
Source: https://github.com/reason-machines/mcp-skills/tree/main/skills/mcpc-mcp-client
Command: npx skills add https://github.com/reason-machines/mcp-skills --skill mcpc-mcp-client-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @apify/mcpc.

What problem does it solve? Interacting with Model Context Protocol servers typically requires writing custom client code, which slows down debugging, scripting, and AI agent integration. This Skill provides a universal CLI client that maps MCP operations to shell commands with persistent sessions and scriptable JSON output. ## Core Features & Use Cases - Persistent Session Management: Connect to multiple MCP servers simultaneously, keep stateful connections alive, and share sessions across agents. - Full MCP Operations: List and call tools, read and subscribe to resources, get prompts, and manage async tasks from the terminal. - OAuth 2.1 Authentication: Log in to remote MCP servers with credentials stored in the OS keychain, with named profiles for staging and production. - Use Case: An AI agent given only a Bash tool can run mcpc connect mcp.apify.com @apify, search tools with mcpc @apify grep "search", and call them with JSON output piped through jq for downstream processing. ## Quick Start Ask the agent to connect to an MCP server with mcpc, search for a relevant tool, and call it with JSON output.

Frequently Asked Questions about mcpc-mcp-client

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

FAQPage Schema
How do I call MCP tools from the command line?▼

Use mcpc to connect to an MCP server, then run tools-call with key:=value arguments, for example mcpc @apify tools-call search-actors keywords:="web scraper". Arguments auto-parse numbers, booleans, and objects, and you can also pass JSON via stdin.

How to authenticate with OAuth for MCP servers?▼

Run mcpc login followed by the server hostname to complete the OAuth 2.1 flow, optionally with --profile for named profiles. Tokens are stored in the OS keychain, with a file-based fallback at ~/.mcpc/credentials on headless Linux.

Can I use mcpc with local MCP servers?▼

Yes, mcpc connects to local servers through Claude Desktop format config files using the syntax mcpc connect ./mcp.json:server-name @alias. Environment variables in the config are expanded with the ${VAR_NAME} syntax.

Does mcpc support JSON output for shell scripting?▼

Yes, the --json flag makes every command emit JSON suitable for jq and xargs pipelines. You can extract tool names, filter results, and chain multiple tool calls in bash scripts.

Why does mcpc fail to store credentials on Linux?▼

Headless Linux lacks a running Secret Service keychain, so mcpc falls back to ~/.mcpc/credentials with mode 0600. To use gnome-keyring, run mcpc inside dbus-run-session with the keyring daemon unlocked.