WURFL Docs MCP Server

The WURFL Docs MCP Server (WDM) makes WURFL documentation and capabilities accessible to your AI assistant through the Model Context Protocol (MCP)—a standard that allows AI assistants like Claude to access external tools and information.

Introduction

With the WURFL Docs MCP Server (WDM), instead of relying on generic or outdated knowledge, your AI assistant can now:

• Query official WURFL documentation in real-time
• Look up authoritative definitions for WURFL capabilities
• Search integration guides and help articles
• View available releases for WURFL API products

This means your AI assistant has access to accurate, up-to-date information directly from ScientiaMobile.

What the WURFL Docs MCP Server Can Do

Access WURFL Documentation

WDM will search and retrieve the complete WURFL API documentation from docs.scientiamobile.com:

• Search documentation by keyword (Python, PHP, Java, Node.js, etc.)
• Retrieve complete integration guides with code examples
• Browse all available WURFL products (InFuze, OnSite, WURFL.js, Microservice, and more)
• Get function definitions and specifications

Example: Ask Claude "How do I integrate my Python project with WURFL API?" and get the latest integration guide automatically.

Query WURFL Capabilities

Explore and understand WURFL device capabilities:

• List all available capabilities with filtering by category or type
• Get authoritative definitions including names, data types, and possible values

Example: Ask "What WURFL capabilities are available for detecting screen size?" to get official information about relevant capabilities.

Browse Support Portal Articles

Access integration guides, tutorials, and best practices from the support portal:

• Integration guides for React, Vue, Angular, Magento, WordPress, and more
• User-Agent Client Hints implementation guides
• Customer Vault usage and management
• WURFL best practices and troubleshooting guides

Example: Ask "Find articles and documentation about React integration with WURFL" to browse relevant help center articles.

Check Package Releases

Browse available software versions for WURFL API products, including modules for WURFL InFuze, WURFL OnSite APIs, WURFL.js, WURFL Microservice, and more.

Example: Ask "What is the latest release for the WURFL Python API, and what is new in the latest release?" to see available versions with release dates.

Getting Started

Prerequisites

You'll need:

• A supported AI assistant. (We currently support Claude Desktop, Claude Code, Cursor, or VS Code Copilot)
• A ScientiaMobile account
• An internet connection for accessing the WURFL Docs MCP Server

Authentication

You'll need a ScientiaMobile account. Authentication happens automatically on first use when you ask the AI assistant a question about WURFL. During setup, you'll log in with your ScientiaMobile account credentials with no special configuration needed.

Choose Your Setup Path

Pick your AI assistant and follow the setup guide:

• Claude Desktop Setup
• Claude Code / CLI Setup
• Cursor Setup
• VS Code Copilot Setup

Next Steps

1. Choose your AI assistant (see "Choose Your Setup Path" above)
2. Follow the setup guide
3. Verify setup by asking your AI a question about WURFL
4. Explore the MCP server's abilities by using example prompts above

Common Questions

Q: Do I need a ScientiaMobile account?

A: Yes, you'll need a ScientiaMobile account to access the WURFL Docs MCP Server. You can register for an account free-of-charge.

Q: What if I'm behind a firewall?

A: Verify your firewall allows connections to https://mcp-docs.scientiamobile.com. Contact your IT department if you have connectivity issues.

Q: How often is the documentation updated?

A: WURFL documentation is updated as ScientiaMobile releases new documentation. The MCP server retrieves current documentation in real-time.

Q: Do I need internet access?

A: Yes, the WURFL Docs MCP Server requires internet connectivity to access documentation and tools.

Q: Is my data secure?

A: Yes. All connections use HTTPS encryption. OAuth tokens are securely cached by your MCP client.

Q: Do you have any tips for the most efficient use of the WURFL Docs MCP Server?

A: Ask clear questions: The more specific, the better results. Use @mentions: Use @wurfl-docs to prioritize tools from specific servers

Claude Desktop Setup

System Requirements

• Claude Desktop installed (download here)
  • Pro, Max, Team, or Enterprise plan required
• ScientiaMobile account
• Internet connection

Setup Steps

Step 1: Open a New Chat

Launch Claude Desktop and click the + button to start a new chat.

Step 2: Access Connectors

In the chat window, expand the + sign, then look for the Connectors option and hover on it.

Click on Manage Connectors to access the connectors management page.

The Connectors management page allows you to add and manage connections to external MCP servers like WURFL Docs.

Step 3: Add Custom Connector

Click the Add custom connector button at the bottom of the page.

Note: The "Add custom connector" feature is currently in BETA, and is limited to account owners. If you don't see this option, or are unable to interact with it, please check with your IT department or contact Claude support.

Step 4: Enter WURFL Docs Server Details

In the Add custom connector dialog:

1. Name: Enter WURFL Docs (or any name you prefer)
2. Remote MCP server URL: Enter: https://mcp-docs.scientiamobile.com/mcp
3. Click Add

Step 5: Connect to WURFL Docs

1. Back in the Connectors list, find WURFL Docs
2. Click the Connect button on the right of WURFL Docs

Step 6: Authenticate with ScientiaMobile

Your browser opens to the ScientiaMobile OAuth login page.

Enter your ScientiaMobile credentials: - Your ScientiaMobile account email - Your ScientiaMobile account password

Step 7: Grant Permissions

1. Review the permissions: mcp:read, mcp:tools
2. Click Allow to grant access

Step 8: Open Claude Desktop

After approving permissions, the browser will ask for permission to return to Claude Desktop. Click Open Claude.

Step 9: Verify Connection

The connector status changes to Connected. You're now ready to use WURFL Docs!

Using MCP Tools in Claude Desktop

In a Claude chat, try asking a question about WURFL:

Example: What WURFL capabilities are available for detecting a phone's physical dimensions

On your first tool use, Claude shows a dialog asking permission to use the WURFL Docs connection. Review the tool description and click Always Allow to permit future uses without prompting.

You're done! Your Claude Desktop is now connected to the WURFL Docs MCP Server. Start asking questions about WURFL documentation, capabilities, and more.

Claude Code / CLI Setup

System Requirements

• Claude Code installed (download here)
• ScientiaMobile account
• Terminal/command line access
• Internet connection

Setup Steps

Step 1: Add the MCP Server

Open your terminal and run this command to add the WURFL Docs MCP Server:

claude mcp add -s user -t http wurfl-docs https://mcp-docs.scientiamobile.com/mcp

Step 2: Verify the MCP Server

Run this command to verify that wurfl-docs appears in your MCP server list:

claude mcp list

Step 3: Launch Claude Code

Start Claude Code by running:

claude

Claude Code opens with a welcome screen:

Step 4: Manage and Authenticate MCP Servers

Type the MCP management command:

/mcp

Claude Code displays a list of all configured MCP servers with their connection status.

Example output:

Step 5: Authenticate

To use the server, you need to authenticate the wurfl-docs MCP server:

1. Navigate using arrow keys to select the server

2. Press Enter to show the details for the MCP server including authentication status

   

3. Press Enter on Authenticate to start the authentication process

   

Claude Code will attempt to open your web browser to the ScientiaMobile OAuth login page. If your browser doesn't open automatically, copy the on-screen URL to your browser manually.

Authentication Flow:

1. Login: Enter your ScientiaMobile email and password

   

2. Consent: Review requested permissions (mcp:read, mcp:tools) and click Allow

   

3. Success Page: A page with a success message will appear

4. Success: Claude confirms that authentication was successful. Use the /mcp command again to verify. The server status should now show √ connected

Example after authentication:

Step 6: Verify Setup

Now type a prompt to verify the server works:

Example: What is the WURFL release_msrp capability?

Claude automatically uses the connected WURFL MCP server to answer your question. You will be asked to allow the usage of the MCP tool. The first time you use a tool, it may take a few seconds—subsequent calls are faster due to caching.

When you allow it, the result will be processed and shown.

Cursor Setup

System Requirements

• Cursor installed (download here)
• ScientiaMobile account
• Internet connection

Setup Steps

Step 1: Open MCP Settings

1. Open Cursor
2. Open the command palette:
   • macOS: Cmd+Shift+P
   • Windows/Linux: Ctrl+Shift+P
3. Type: MCP
4. Click on View: Open MCP Settings

Step 2: Configure the WURFL Docs MCP Server

The Tools & MCP settings panel opens automatically.

Click on the Add Custom MCP button. The mcp.json file will open.

Production Configuration (Recommended)

Add the wurfl-docs field to your mcpServers section:

{
  "mcpServers": {
    "wurfl-docs": {
      "transport": "http",
      "url": "https://mcp-docs.scientiamobile.com/mcp"
    }
  }
}

Step 3: Save Configuration

1. Save the file (Cmd+S or Ctrl+S)
2. Cursor automatically reloads the MCP configuration
3. No restart required! (Unlike other editors)

Configuration changes take effect immediately in Cursor.

Cursor will notify you that the MCP Server needs authentication. Click on the notification.

If you miss the notification, don't worry — Cursor will ask you again on first use, or you can navigate to the Tools & MCP Panel directly.

Step 4: Set Up Authentication

In the Tools & MCP Panel you will see the wurfl-docs MCP Server and a text that says Needs authentication.

Click on the Connect button on the right.

Cursor will ask you to open a browser window. Click on the Open button.

Your default browser will open to the ScientiaMobile authentication form.

Authentication Flow

1. Login: Enter your ScientiaMobile email and password

   

2. Consent: Review requested permissions (mcp:read, mcp:tools) and click Allow

   

3. Redirect: The browser will ask for permission to redirect you back to Cursor. Click Open Cursor.

   

4. The connector status now shows 10 tools and 1 prompt enabled.

   

Using MCP Tools in Cursor

Chat Panel

The Chat Panel is the main interface for using MCP tools. Open it with Cmd+Shift+L (Ctrl+Shift+L on Windows/Linux):

Example: Use the wurfl-docs MCP connector to list all WURFL capabilities related to a device's chipset.

VS Code Copilot Setup

System Requirements

• VS Code installed (download here)
• GitHub Copilot extension installed and activated
• ScientiaMobile account
• Internet connection

Setup Steps

Step 1: Execute MCP: Add Server

1. Open VS Code
2. Open the command palette:
   • macOS: Cmd+Shift+P
   • Windows/Linux: Ctrl+Shift+P
3. Type: MCP: Add Server

4. Press Enter

Step 2: MCP Server Type Prompt

Select HTTP from the options displayed.

Step 3: Enter Server URL

VS Code will show you a prompt where to enter the server URL.

Enter the following address:

https://mcp-docs.scientiamobile.com/mcp

Press Enter.

Step 4: MCP Server ID

VS Code will ask you to name the MCP server.

Type in a descriptive ID of your choosing and hit Enter.

Step 5: Configuration Target

VS Code will ask you to choose whether the configuration target is Workspace or Global.

VS Code provides different scopes for settings. From VS Code documentation:

• Global settings — Settings that apply globally to any instance of VS Code you open.
• Workspace settings — Settings stored inside a workspace and only apply when that workspace is opened.

Step 6: Authentication

VS Code will automatically open the mcp.json file and shortly after an alert will ask you to allow authentication.

Click on the Allow button.

Next, VS Code will ask you to open a browser window. Click on the Open button.

Your default browser will open to the ScientiaMobile authentication form.

Authentication Flow:

1. Login: Enter your ScientiaMobile email and password

   

2. Consent: Review requested permissions (mcp:read, mcp:tools) and click Allow

   

   Note: The AI assistant named on the permissions screen will vary depending on which AI model you have configured in VS Code Copilot.

3. Redirect: The browser will ask you to allow it to redirect you back to VS Code. Click Open ...

Step 7: Verify Configuration

Verify that the mcp.json file that should already be open contains the following:

{
    "servers": {
        "wurfl-docs": {
            "url": "https://mcp-docs.scientiamobile.com/mcp",
            "type": "http"
        }
    },
    "inputs": []
}

Using MCP Tools in VS Code Copilot

Now you can use the VS Code Chat feature to talk to your preferred AI model and allow it to use the WURFL Docs MCP Server tools.

Example: What are the latest WURFL OnSite API for .NET package releases?

Managing MCP Servers

View Configured Servers

1. Open the command palette: Cmd+Shift+P (macOS) / Ctrl+Shift+P (Windows/Linux)
2. Type: MCP: List Servers

This will show you a list of all configured MCP servers with their connection status. Select the server you want to manage and hit Enter.

---

© 2026 ScientiaMobile Inc.
All Rights Reserved.

NOTICE: All information contained herein is, and remains the property of ScientiaMobile Incorporated and its suppliers, if any. The intellectual and technical concepts contained herein are proprietary to ScientiaMobile Incorporated and its suppliers and may be covered by U.S. and Foreign Patents, patents in process, and are protected by trade secret or copyright law. Dissemination of this information or reproduction of this material is strictly forbidden unless prior written permission is obtained from ScientiaMobile Incorporated.