@evantahler/mcpx 0.15.0 → 0.15.3

package/README.md

@@ -2,6 +2,8 @@
 
 A command-line interface for MCP servers. **curl for MCP.**
 
+The internet is debating CLI vs MCP like they're competitors. [They're not.](https://arcade.dev/blog/curl-for-mcp)
+
 Two audiences:
 
 1. **AI/LLM agents** that prefer shelling out over maintaining persistent MCP connections — better for token management, progressive tool discovery, and sharing a single pool of MCP servers across multiple agents on one machine
@@ -622,6 +624,10 @@ bun lint
 
 Inspired by [mcp-cli](https://github.com/philschmid/mcp-cli) by Phil Schmid, which nails the core DX of a shell-friendly MCP client. mcpx extends that foundation with OAuth support for HTTP servers and semantic tool search.
 
+## Why mcpx?
+
+The full story: [curl for MCP: Why Coding Agents Are Happier Using the CLI](https://arcade.dev/blog/curl-for-mcp)
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evantahler/mcpx",
-  "version": "0.15.0",
+  "version": "0.15.3",
   "description": "A command-line interface for MCP servers. curl for MCP.",
   "type": "module",
   "bin": {

package/.claude/settings.local.json

@@ -1,18 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "WebFetch(domain:github.com)",
-      "Bash(bun lint:*)",
-      "Bash(bun:*)",
-      "WebFetch(domain:docs.arcade.dev)",
-      "Bash(grep:*)",
-      "WebSearch",
-      "Bash(wc:*)",
-      "Bash(gh release:*)",
-      "Bash(gh run:*)",
-      "Bash(mcpcli search:*)",
-      "Bash(mcpcli call:*)",
-      "Bash(mcpcli:*)"
-    ]
-  }
-}

package/.claude/worktrees/elastic-jennings/.claude/settings.local.json

@@ -1,18 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "WebFetch(domain:github.com)",
-      "Bash(bun lint:*)",
-      "Bash(bun:*)",
-      "WebFetch(domain:docs.arcade.dev)",
-      "Bash(grep:*)",
-      "WebSearch",
-      "Bash(wc:*)",
-      "Bash(gh release:*)",
-      "Bash(gh run:*)",
-      "Bash(mcpcli search:*)",
-      "Bash(mcpcli call:*)",
-      "Bash(mcpcli:*)"
-    ]
-  }
-}

package/.claude/worktrees/elastic-jennings/.claude/skills/mcpcli.md

@@ -1,93 +0,0 @@
----
-name: mcpcli
-description: Discover and use MCP tools via the mcpcli CLI
-trigger: when the user wants to interact with external services, APIs, or MCP tools
----
-
-# mcpcli — MCP Tool Discovery and Execution
-
-You have access to external tools via `mcpcli`. Use this workflow:
-
-## 1. Search for tools
-
-```bash
-mcpcli search "<what you want to do>"
-```
-
-## 2. Inspect the tool schema
-
-```bash
-mcpcli info <server> <tool>
-```
-
-This shows parameters, types, required fields, and the full JSON Schema.
-
-## 3. Execute the tool
-
-```bash
-mcpcli exec <server> <tool> '<json args>'
-```
-
-## Rules
-
-- Always search before executing — don't assume tool names exist
-- Always inspect the schema before executing — validate you have the right arguments
-- Use `mcpcli search -k` for exact name matching
-- Pipe results through `jq` when you need to extract specific fields
-- Use `-v` for verbose HTTP debugging if an exec fails unexpectedly
-
-## Examples
-
-```bash
-# Find tools related to sending messages
-mcpcli search "send a message"
-
-# See what parameters Slack_SendMessage needs
-mcpcli info arcade Slack_SendMessage
-
-# Send a message
-mcpcli exec arcade Slack_SendMessage '{"channel":"#general","message":"hello"}'
-
-# Chain commands — search repos and read the first result
-mcpcli exec github search_repositories '{"query":"mcp"}' \
-  | jq -r '.content[0].text | fromjson | .items[0].full_name' \
-  | xargs -I {} mcpcli exec github get_file_contents '{"owner":"{}","path":"README.md"}'
-
-# Read args from stdin
-echo '{"path":"./README.md"}' | mcpcli exec filesystem read_file
-```
-
-## Authentication
-
-Some HTTP servers require OAuth. If you see an "Not authenticated" error:
-
-```bash
-mcpcli auth <server>        # authenticate via browser
-mcpcli auth <server> -s     # check token status and TTL
-mcpcli auth <server> -r     # force token refresh
-mcpcli deauth <server>      # remove stored auth
-```
-
-## Available commands
-
-| Command                                | Purpose                           |
-| -------------------------------------- | --------------------------------- |
-| `mcpcli`                               | List all servers and tools        |
-| `mcpcli -d`                            | List with descriptions            |
-| `mcpcli info <server>`                 | Show tools for a server           |
-| `mcpcli info <server> <tool>`          | Show tool schema                  |
-| `mcpcli exec <server>`                 | List tools for a server           |
-| `mcpcli exec <server> <tool> '<json>'` | Execute a tool                    |
-| `mcpcli search "<query>"`              | Search tools (keyword + semantic) |
-| `mcpcli search -k "<pattern>"`         | Keyword/glob search only          |
-| `mcpcli search -q "<query>"`           | Semantic search only              |
-| `mcpcli index`                         | Build/rebuild search index        |
-| `mcpcli index -i`                      | Show index status                 |
-| `mcpcli auth <server>`                 | Authenticate with OAuth           |
-| `mcpcli auth <server> -s`              | Check token status and TTL        |
-| `mcpcli auth <server> -r`              | Force token refresh               |
-| `mcpcli deauth <server>`               | Remove stored authentication      |
-| `mcpcli add <name> --command <cmd>`    | Add a stdio MCP server            |
-| `mcpcli add <name> --url <url>`        | Add an HTTP MCP server            |
-| `mcpcli remove <name>`                 | Remove an MCP server              |
-| `mcpcli skill install --claude`        | Install mcpcli skill for Claude   |

package/.claude/worktrees/elastic-jennings/.github/workflows/auto-release.yml

@@ -1,117 +0,0 @@
-name: Auto Release
-
-on:
-  push:
-    branches: [main]
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  id-token: write
-
-jobs:
-  check-version:
-    runs-on: ubuntu-latest
-    outputs:
-      should_release: ${{ steps.check.outputs.should_release }}
-      tag: ${{ steps.version.outputs.tag }}
-      version: ${{ steps.version.outputs.version }}
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Get version from package.json
-        id: version
-        run: |
-          VERSION=$(jq -r .version package.json)
-          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
-
-      - name: Check if release exists
-        id: check
-        run: |
-          if gh release view "${{ steps.version.outputs.tag }}" &>/dev/null; then
-            echo "should_release=false" >> "$GITHUB_OUTPUT"
-          else
-            echo "should_release=true" >> "$GITHUB_OUTPUT"
-          fi
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  create-release:
-    needs: check-version
-    if: needs.check-version.outputs.should_release == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Create release
-        run: |
-          gh release create "${{ needs.check-version.outputs.tag }}" \
-            --title "${{ needs.check-version.outputs.tag }}" \
-            --generate-notes
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  ci:
-    needs: [check-version, create-release]
-    if: needs.check-version.outputs.should_release == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - run: bun install --frozen-lockfile
-      - run: bun lint
-      - run: bun test
-
-  publish-npm:
-    needs: [check-version, ci]
-    if: needs.check-version.outputs.should_release == 'true'
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      id-token: write
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org
-      - run: npm install -g npm@latest
-      - run: bun install --frozen-lockfile
-      - run: npm publish --provenance --access public
-
-  build-binaries:
-    needs: [check-version, ci]
-    if: needs.check-version.outputs.should_release == 'true'
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        include:
-          - target: bun-darwin-arm64
-            artifact: mcpcli-darwin-arm64
-          - target: bun-darwin-x64
-            artifact: mcpcli-darwin-x64
-          - target: bun-linux-arm64
-            artifact: mcpcli-linux-arm64
-          - target: bun-linux-x64
-            artifact: mcpcli-linux-x64
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - run: bun install --frozen-lockfile
-      - name: Build binary
-        run: |
-          bun build --compile --minify --sourcemap \
-            --target=${{ matrix.target }} \
-            --define BUILD_VERSION="'\"${{ needs.check-version.outputs.version }}\"'" \
-            ./src/cli.ts --outfile dist/${{ matrix.artifact }}
-      - name: Upload to release
-        run: gh release upload "${{ needs.check-version.outputs.tag }}" dist/${{ matrix.artifact }} --clobber
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/.claude/worktrees/elastic-jennings/.github/workflows/ci.yml

@@ -1,18 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  check:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v2
-        with:
-          bun-version: latest
-      - run: bun install --frozen-lockfile
-      - run: bun lint
-      - run: bun test

package/.claude/worktrees/elastic-jennings/.prettierignore

@@ -1,4 +0,0 @@
-node_modules
-dist
-bun.lock
-.claude

package/.claude/worktrees/elastic-jennings/.prettierrc

@@ -1,7 +0,0 @@
-{
-  "semi": true,
-  "singleQuote": false,
-  "trailingComma": "all",
-  "printWidth": 100,
-  "tabWidth": 2
-}

package/.claude/worktrees/elastic-jennings/CLAUDE.md

@@ -1,19 +0,0 @@
-# CLAUDE.md
-
-## Project
-
-mcpcli — A CLI for MCP servers. "curl for MCP."
-
-## Commands
-
-- `bun run dev` — Run in development mode
-- `bun test` — Run tests
-- `bun lint` — Check formatting (prettier)
-- `bun format` — Auto-fix formatting
-- `bun run build` — Build single binary
-
-## Rules
-
-- **Always bump the patch version in `package.json`** when making any code changes (source, tests, config). Use semver: patch for fixes/small changes, minor for new features, major for breaking changes.
-- **Always keep `README.md` and `.claude/skills/mcpcli.md` in sync** with any CLI changes (commands, flags, syntax, examples). The skill file includes workflow steps, code examples, and a command table that must all reflect the current CLI surface.
-- **Always run `bun run format`** before committing to fix prettier formatting issues.

package/.claude/worktrees/elastic-jennings/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Evan Tahler
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.