MCP Client:

by pinax-network

6 stars
326 downloads
Not rated
GitHub

About

An MCP Client for connecting to MCP Server‐compatible services at https://app.pinax.network.

Details

Author
pinax-network
GitHub stars
6
Downloads
326
Categories
Other, API

- Connects MCP clients to remote MCP servers via stdio transport
- Uses JWT access tokens for authentication
- Provides verbose logging for troubleshooting (option -v true)
- Works with any MCP‑compatible application
- Allows local development with Bun

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Client:
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install and run via npx @pinax/mcp, providing a remote server URL and a JWT access token. You can configure it in Claude Desktop’s configuration file (claude_desktop_config.json) using either command‑line arguments or environment variables.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp client:": {
            "pinax-mcp": {
                "command": "npx",
                "args": [
                    "@pinax/mcp",
                    "--remote-url",
                    "https://example.com/mcp",
                    "--access-token",
                    "YOUR_TOKEN",
                    "-v",
                    "true"
                ]
            }
        }
    }
}

McpServers

{
    "pinax-mcp": {
        "command": "npx",
        "args": [
            "@pinax/mcp",
            "--remote-url",
            "https://example.com/mcp",
            "--access-token",
            "YOUR_TOKEN",
            "-v",
            "true"
        ]
    }
}

MCP Client: @pinax/mcp

license

> An MCP Client for connecting to MCP Server‐compatible services at https://app.pinax.network.

Usage

Usage: @pinax/mcp [options]

A bridge client for connecting Claude Desktop and other MCP-compatible clients to remote MCP servers.

Options:
-V, --version output the version number
--remote-url <string> Remote MCP server URL (env: REMOTE_URL)
--access-token <string> JWT Access Token (env: ACCESS_TOKEN)
-v, --verbose <boolean> Enable verbose logging (choices: "true", "false", default: false, env: VERBOSE)
-h, --help display help for command

Documentation: https://app.pinax.network/docs/guides/mcp

Endpoints

This MCP allows LLMs to access data provided by the Pinax Token API.

- Use https://mcp.pinax.network for the MCP server (Streamable HTTP)

Authentication

1. Sign in at https://app.pinax.network
2. Go to Keys
3. Copy your project key and generate a JWT Access Token

Configuration

Environment Variables (.env)

ACCESS_TOKEN=<your-jwt-token-from-app.pinax.network>
REMOTE_URL=https://mcp.pinax.network

Claude Desktop Configuration

Add to your Claude Desktop config file:

Location:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

Configuration:

{
"mcpServers": {
"pinax": {
"command": "npx",
"args": [
"@pinax/mcp",
"--remote-url",
"https://mcp.pinax.network",
"--access-token",
"YOUR_ACCESS_TOKEN_HERE"
]
}
}
}

Or using environment variables:

{
  "mcpServers": {
    "pinax": {
      "command": "npx",
      "args": ["@pinax/mcp"],
      "env": {
        "REMOTE_URL": "https://mcp.pinax.network",
        "ACCESS_TOKEN": "YOUR_ACCESS_TOKEN_HERE"
      }
    }
  }
}

Using with Bun (Development)

{
  "mcpServers": {
    "pinax": {
      "command": "/path/to/bun",
      "args": [
        "run",
        "/path/to/pinax-mcp/index.ts",
        "--remote-url",
        "http://localhost:8080/mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN_HERE",
        "-v",
        "true"
      ]
    }
  }
}

Supported Clients

This bridge works with any MCP client that supports stdio transport:

- Claude Desktop
- Cline
- Cursor
- Any other MCP-compatible application

Troubleshooting

Enable Verbose Logging

Add -v true to your command or set VERBOSE=true in your environment:

npx @pinax/mcp --remote-url https://example.com/mcp --access-token YOUR_TOKEN -v true

Common Issues

Connection Timeout:
- Verify your ACCESS_TOKEN is valid
- Check that the REMOTE_URL is correct and accessible

Authentication Failed:
- Generate a new access token at https://app.pinax.network/keys
- Ensure the token hasn't expired

Server Disconnected:
- Check Claude Desktop logs for detailed error messages
- Verify network connectivity to the remote server

Development

Install Dependencies

```bash
npm install

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.