Pine Assistant MCP Server

A local MCP server that lets any LLM agent manage Pine AI tasks — negotiate bills, cancel subscriptions, resolve disputes, and make phone calls on your behalf.

Built on the pine-assistant Python SDK.

Installation

pip install pine-mcp-server

Or run directly with uvx (no install needed):

uvx pine-mcp-server

Quick Start

1. Get your Pine AI credentials

You need an access_token and user_id from Pine AI. Either:

• Sign up at 19pine.ai and retrieve your credentials, or

• Use the built-in auth tools (pine_auth_request_code / pine_auth_verify_code) to authenticate via email.

2. Configure your MCP client

Claude Desktop — edit claude_desktop_config.json:

{
  "mcpServers": {
    "pine-assistant": {
      "command": "uvx",
      "args": ["pine-mcp-server"],
      "env": {
        "PINE_ACCESS_TOKEN": "your-access-token",
        "PINE_USER_ID": "your-user-id"
      }
    }
  }
}

Cursor — edit .cursor/mcp.json:

{
  "mcpServers": {
    "pine-assistant": {
      "command": "uvx",
      "args": ["pine-mcp-server"],
      "env": {
        "PINE_ACCESS_TOKEN": "your-access-token",
        "PINE_USER_ID": "your-user-id"
      }
    }
  }
}

If you prefer pip install, replace "command": "uvx" with "command": "pine-mcp-server" and remove the "args" field.

3. Use it

Ask your LLM agent something like:

"Use Pine AI to negotiate my Comcast internet bill. My account number is 12345."

The agent will create a session, send your request, and check back for updates.

How It Works

The server follows a "load conversation" model — like refreshing a browser page:

1. Create a session — pine_session_create

2. Send a message describing the task — pine_send_message

3. Wait, then check what Pine replied — pine_get_history

4. Start the task when ready — pine_task_start

5. Check again for results — pine_get_history

There is no real-time streaming. The agent periodically loads the conversation history to see updates, similar to refreshing the Pine web app.

Available Tools

Authentication

Sessions

Conversation

Tasks

Attachments

Social & Scheduling

Environment Variables

* Not required if you authenticate at runtime using the auth tools.

Development

pip install -e ".[dev]"

License

MIT