Pararam Nexus MCP

A Model Context Protocol (MCP) server for interacting with pararam.io - a modern communication and collaboration platform.

About pararam.io

Pararam.io is a communication platform that provides:

• Messaging: Create groups and private chats

• Team Organization: Organize people into teams

• Communication: Group and private calls (audio and video)

• Cross-platform: Available on mobile (iOS, Android, Huawei) and web

This MCP server uses the pararamio-aio library to provide asynchronous access to pararam.io features through the Model Context Protocol.

Features

• Asynchronous API client for pararam.io

• Two-factor authentication support (TOTP)

• Session persistence with cookie storage

• Comprehensive chat and message management

• File attachment handling (upload and download)

• URL-based message retrieval

• Conversation thread building

Available Tools

Message Operations

• search_messages: Search for messages across all chats with advanced search syntax (Boolean operators, wildcards, filters)

• get_chat_messages: Get recent messages from a specific chat

• send_message: Send a message to a chat with optional reply and quote text

• get_message_from_url: Extract and retrieve a message from pararam.io URL

Chat Operations

• search_chats: Search for chats by name or description

• build_conversation_thread: Build a conversation tree from a root message

File Operations

• upload_file_to_chat: Upload files to a chat (from path or base64 content)

• get_post_attachments: List all attachments in a post

• download_post_attachment: Download attachments (to disk or as ImageContent)

  • 1MB size limit for downloads

  • Supported formats for direct display: images (JPEG, PNG, GIF, WEBP), documents (PDF, DOCX, DOC, TXT, RTF, ODT, HTML, EPUB), spreadsheets (XLSX, XLS, CSV), data (JSON, XML)

  • Returns ImageContent for supported types (displays natively in Claude Desktop/Code)

  • For unsupported types, requires output_path to save to disk

  • Saves to disk when output path is provided

User Operations

• search_users: Search for users by name or unique name

• get_user_info: Get detailed information about a specific user

• get_user_team_status: Get user's status in teams (member, admin, guest)

Tool Details

send_message

Send a message to a chat with optional reply and quote functionality.

Parameters:

• chat_id (required): ID of the chat to send message to

• text (required): Message text to send

• reply_to_message_id (optional): Post number to reply to

• quote_text (optional): Text to quote from the replied message (only used with reply_to_message_id)

Examples:

Installation

Quick Install with uvx (Recommended)

Install directly from PyPI:

Or install from GitHub:

Or clone to a specific directory (e.g., ~/.mcp/):

Docker Installation

Pull from Docker Hub:

Or from GitHub Container Registry:

Development Installation

For local development:

Configuration

Create a .env file with your pararam.io credentials:

MCP Client Configuration

Claude Code (CLI)

Add the server using the Claude Code CLI:

Claude Desktop

Option 1: Using uvx (Recommended)

1. Open Claude Desktop preferences

2. Navigate to the MCP section

3. Click Edit to open claude_desktop_config.json

4. Add the server configuration:

Option 2: Using Docker

First, create a volume for session persistence:

Then add to claude_desktop_config.json:

Cursor IDE

Add to .cursor/mcp.json:

Or using Docker (with session persistence):

First, create a volume:

Then add to .cursor/mcp.json:

Other MCP-Compatible Clients

For any MCP-compatible client that supports stdio transport:

Using uvx:

Using Docker (with session persistence):

Environment variables:

• PARARAM_LOGIN (required): Your pararam.io login

• PARARAM_PASSWORD (required): Your pararam.io password

• PARARAM_2FA_KEY (optional): Your 2FA secret key for TOTP authentication

Usage

If installed with uvx:

If cloned locally:

For development:

Development

Install pre-commit hooks:

Run linting and formatting:

Run type checking:

Run tests:

Dependencies

• FastMCP: Model Context Protocol server framework

• pararamio-aio: Async Python client for pararam.io API

• httpx: Modern HTTP client

• Pydantic: Data validation using Python type annotations

License

MIT