Pararam Nexus

You are equipped with a dedicated MCP server that lets you interact with pararam.io’s messaging, teams, calls, and file features from your Model Context Protocol client. It enables asynchronous access, two-factor authentication, and robust session persistence so you can build rich chat workflows and automate pararam.io actions from your preferred MCP client.

How to use

Connect to the Pararam Nexus MCP server from your MCP client and start performing common actions like sending messages, searching chats, managing files, and retrieving messages from URLs. Use the existing tools to build conversation trees, fetch chat history, upload files, and access user information. Make sure your client is configured with the correct MCP server definitions and the required environment variables for authentication.

How to install

Prerequisites you need before installation: a compatible MCP client, Python, and the ability to run external commands on your system.

# Quick install with uvx (recommended)
uvx pararam-nexus-mcp

# Or install from GitHub and set up
uvx --from git+https://github.com/ivolnistov/pararam-nexus-mcp pararam-nexus-mcp

# Or clone locally and sync
git clone https://github.com/ivolnistov/pararam-nexus-mcp.git ~/.mcp/pararam-nexus-mcp
cd ~/.mcp/pararam-nexus-mcp
uv sync

Configuration and usage notes

Create a .env file with your pararam.io credentials to enable authentication. The fields you need are the login, password, and an optional 2FA secret if you use TOTP.

PARARAM_LOGIN=your_login
PARARAM_PASSWORD=your_password
PARARAM_2FA_KEY=your_2fa_key  # Optional

Starter commands for MCP clients

Add the Pararam Nexus MCP server to your MCP client using the supported client-specific method. The examples below show two common ways to run the server configuration with environment variables.

# Using uvx (recommended) entry point for the MCP server
claude mcp add pararam-nexus \
  --env PARARAM_LOGIN=myuser@example.com \
  --env PARARAM_PASSWORD=mySecurePassword123 \
  --env PARARAM_2FA_KEY=JBSWY3DPEHPK3PXP \
  -- uvx pararam-nexus-mcp

# Using Docker (alternative)
claude mcp add pararam-nexus \
  --env PARARAM_LOGIN=myuser@example.com \
  --env PARARAM_PASSWORD=mySecurePassword123 \
  --env PARARAM_2FA_KEY=JBSWY3DPEHPK3PXP \
  -- docker run -i --rm ivolnistov/pararam-nexus-mcp:latest

Notes on session persistence and attachments

The MCP server supports session persistence via cookie storage to keep you logged in across restarts. When working with file attachments, you can upload to a chat and retrieve post attachments. For downloads, the server supports direct display formats for common document, image, and data types.

Troubleshooting tips

If you encounter authentication issues, verify that your PARARAM_LOGIN and PARARAM_PASSWORD are correct and that your 2FA key (if used) is valid. Ensure the environment variables are correctly passed to your MCP client configuration.

Available tools

send_message

Send a message to a chat with optional reply and quoted text, enabling conversational workflows.

get_chat_messages

Retrieve recent messages from a specific chat to stay up to date with conversations.

search_messages

Search messages across chats using advanced syntax, including Booleans and filters.

get_message_from_url

Extract and retrieve a message directly from a pararam.io URL.

search_chats

Find chats by name or description to locate relevant conversations quickly.

build_conversation_thread

Construct a conversation tree from a root message to understand context and replies.

upload_file_to_chat

Upload files to a chat from a file path or base64 content for sharing.

get_post_attachments

List all attachments in a post to manage shared media.

download_post_attachment

Download attachments to disk or return as ImageContent for direct display; supports a 1MB download limit.

search_users

Find users by name or unique username to coordinate collaboration.

get_user_info

Fetch detailed information about a specific user.

get_user_team_status

Get a user’s status within teams (member, admin, guest).