Skip to main content
Current Status: Generally Available (as of Victorious Vicuna). With the Victorious Vicuna release, Paradigm fully supports the ability to connect to external MCP servers. This feature greatly extends the platform’s scope by allowing customers to call any MCP server of their choice directly from Paradigm.
⚠️ Note on Agents: This functionality requires the Agent feature to be enabled on your environment.

​
What is an MCP server?

An MCP (Model Context Protocol) server provides external knowledge, data, or tools that Paradigm agents can query. It allows customers to connect Paradigm with their own systems or third-party providers.

​
Limitations & Quality

  • Dependency on MCP quality: Performance and accuracy depend entirely on the search/retrieval mechanisms of the configured MCP server.
  • Data Integration: Responses from an MCP server are not indexed into Paradigm’s internal database. Paradigm relies on the MCP’s own search engine. Results may vary depending on the configuration and reliability of the chosen provider.

​
Step 1: Configure an MCP Server

Configuration is managed in Admin > MCP Servers.

​
Visibility & Security Rules (New in Victorious Vicuna)

To ensure strict data segregation between companies, visibility of MCP details is now scoped based on your role (System Admin vs. Company Admin) and the ownership of the MCP server.
RoleMCP Ownership / ScopeVisibility Details
System AdminOwned by my company OR “All Companies”Full Access: Can see and edit all fields.
System AdminNot owned by my companyRestricted: Only the Name is visible (Read-only). The URL and configuration details are hidden.
Company AdminOwned by my companyEdit Access: Can modify Name, URL, and Token. Availability Scope is read-only.
Company AdminScope set to “All Companies” (Public)Read-Only: Can only see the Name. URL and details are hidden.

​
How to Add a New Server

  1. Go to Admin > MCP Servers.
  2. Click New.
  3. Fill in the following information:
    • Name: A human-readable name for the MCP server (e.g., paradigm-docs).
    • URL: The endpoint of the MCP server (e.g., https://lighton.mintlify.app/mcp).
    • Bearer token (optional): Authentication token if required (stored encrypted).
    • Enabled: Toggle to enable/disable this server.
  4. Availability Scope: Define which companies can access this server.
  5. Click Save.
Once saved, the server is registered in Paradigm but must be associated with a chat setting to be used.

​
Step 2: Manage Tools & Chat Settings

Once the MCP server is configured, it appears in the Tools list.

​
Managing the Tools List

Go to the Tools admin page.
  • System Admins can now filter MCP tool groups by Owner Company.
  • Security Note: You will not be able to view the URLs of MCP servers included in tool groups that do not belong to your company.

​
Enable in Chat Settings

To make the MCP active for end-users:
  1. Go to Chat Settings and select the desired configuration.
  2. Enable Agent mode (“Enable agent functionality for this chat setting”).
  3. Under Agent Tools, add the configured MCP server to the list of chosen tools.
The MCP server will now be available to the agent during chats in this specific configuration.

​
Example MCP Servers

Here are some existing MCP servers you could integrate:
  • Arxiv MCP (https://arxiv-mcp.replit.app)
    • Use case: Query scientific publications and preprints from arXiv.
  • Wikipedia MCP (https://wiki-mcp.replit.app)
    • Use case: Retrieve knowledge from Wikipedia for general-purpose enrichment.
  • GitHub Issues MCP (https://github-issues-mcp.replit.app)
    • Use case: Query issues from GitHub repositories.
  • Weather MCP (https://weather-mcp.replit.app)
    • Use case: Provide real-time weather data for travel or logistics.
  • File System MCP (https://fs-mcp.replit.app)
    • Use case: Access and retrieve documents from a specified file system.