1nce MCP Server

🚀 1NCE IoT Platform MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with the 1NCE IoT Connectivity Management Platform using natural language.

🚀 Quick Start

This project offers a middleware layer that connects Large Language Models (LLMs) to the 1NCE API for IoT connectivity management. It allows AI assistants to:

• Retrieve product information
• Manage orders
• Monitor SIM card status
• Check data and SMS quotas
• Update SIM configurations
• View connectivity status

With these capabilities through the Model Context Protocol, AI agents can interact with the IoT infrastructure using natural language, simplifying the management of connected devices.

✨ Features

• Authentication: Secure authentication based on OAuth 2.0 tokens using the 1NCE API.
• Product Management: Query available IoT connectivity products.
• Order Management: Create and track orders.
• SIM Management: Monitor and configure SIM cards.
• Resources: Direct access to SIM status and product data.
• Prompts: Pre - defined interaction templates for common tasks.

📦 Installation

Prerequisites

• Python 3.8+
• FastMCP v2
• A 1NCE account with API credentials

Steps

1. Clone this repository

git clone https://github.com/yourusername/1nce-mcp-server.git
cd 1nce-mcp-server

2. Install the required dependencies

pip install fastmcp httpx

3. Set environment variables using your 1NCE API credentials

export ONCE_CLIENT_ID="your_client_id"
export ONCE_CLIENT_SECRET="your_client_secret"

💻 Usage Examples

Installation with FastMCP

It is recommended to install this MCP server using the FastMCP CLI:

fastmcp install 1nce_mcp.py

This will make the server available to compatible MCP clients, including Claude Desktop.

Direct Execution

For development or testing, you can run the server directly:

python 1nce_mcp.py

Using the Client

You can use the FastMCP client to interact with the server programmatically:

from fastmcp import Client

async with Client("1nce_mcp.py") as client:
    # Get a list of all products
    products = await client.call_tool("get_all_products")
    print(products)
    
    # Check SIM status
    sim_status = await client.call_tool("get_sim_status", {"iccid": "your_sim_iccid"})
    print(sim_status)

Available Tools

Product Tools

• get_all_products() - Get a list of all available 1NCE products

Order Tools

• get_all_orders(page, page_size, sort) - Get a list of orders with pagination
• get_order_by_number(order_number) - Get detailed information about a specific order
• create_order(products, delivery_address, customer_reference) - Create a new order

SIM Tools

• get_all_sims(page, page_size, query, sort) - List SIM cards with filtering options
• get_sim_details(iccid) - Get detailed information about a specific SIM
• get_sim_status(iccid) - Check the connectivity status of a SIM
• get_sim_data_quota(iccid) - Check the remaining data quota of a SIM