pinelabs-online-mcp: Skill for Claude Code

Pine Labs MCP Troubleshoot

Diagnose and resolve issues with the Pine Labs MCP server running locally.

When to Use

• Server won't start or crashes immediately
• MCP client shows "server disconnected" or "failed to connect"
• Authentication errors (401, invalid credentials, token failures)
• Tools don't appear in the MCP client
• API calls return unexpected errors
• Tests fail after setup
• Docker container exits or won't build

Diagnostic Procedure

Follow this sequence — each step narrows the problem category.

Step 1: Verify Python Environment

# Check Python version (need 3.10+)
python3 --version

# Check virtual environment is active
which python
# Should point to .venv/bin/python, NOT system Python

# If not active:
source .venv/bin/activate

# Check dependencies installed
pip list | grep -E "fastmcp|httpx|pydantic"
# All three must be present

Common fix: pip install -r requirements.txt

Step 2: Verify Server Starts

# Start with debug logging
python -m cli.pinelabs_mcp_server.main stdio \
  --client-id <ID> --client-secret <SECRET> \
  --env uat --log-level DEBUG --log-file /tmp/mcp-debug.log

Check the log file for errors:

cat /tmp/mcp-debug.log

Common errors:

Error	Cause	Fix
ModuleNotFoundError: cli	Wrong working directory	cd to project root
ModuleNotFoundError: fastmcp	Dependencies not installed	pip install -r requirements.txt
ImportError	Python version too old	Upgrade to 3.10+
Address already in use	Port conflict (HTTP mode)	Use different --port or kill existing process

Step 3: Verify Credentials

# Test authentication directly
python -c "
import asyncio
from pkg.pinelabs.client import PineLabsClient

async def test():
    client = PineLabsClient(
        client_id='<ID>',
        client_secret='<SECRET>',
        base_url='https://pluraluat.v2.pinepg.in/api',
        token_url='https://pluraluat.v2.pinepg.in/api/auth/v1/token',
    )
    token = await client._get_token()
    print(f'Token obtained: {token[:20]}...')
    await client.close()

asyncio.run(test())
"