MCPie

HTTPie for MCP servers. Connect to and call tools on Model Context Protocol servers from the terminal.

Supports stdio, SSE, and streamable HTTP transports. Handles OAuth 2.1 PKCE automatically.

Install

go install github.com/ammmir/mcpie@latest

Or grab a binary from releases.

Usage

Register a server:

mcpie connect streamable http://localhost:3000/mcp
mcpie connect sse https://api.example.com/mcp --bearer mytoken
mcpie connect stdio /usr/local/bin/my-mcp-server

List tools:

mcpie tools list
mcpie tools list myhost -v   # verbose: descriptions and types

Call a tool:

mcpie tools call ping
mcpie tools call list_users active_only:=true per_page:=25
mcpie tools call create_item name=Test 'tags[]=vip' 'tags[]=pro'
mcpie tools call nested 'data[user][name]=Alice' 'data[user][age]:=30'

Argument syntax mirrors HTTPie:

Syntax	Meaning
key=value	string
key:=value	raw JSON (number, bool, null, object, array)
key[sub]=value	nested object
key[]=value	append to array
key[0]=value	array by index

zsh users: quote arguments with [] or add alias mcpie="noglob mcpie" to ~/.zshrc.

JSON output for scripting:

mcpie --json tools list | jq .

Manage hosts:

mcpie hosts
mcpie hosts show myhost
mcpie hosts remove myhost

Build

make build    # local binary
make install  # go install
make test