Blues Expert MCP

Blues Expert is a Model Context Protocol (MCP) server that helps generative AI tools build with Blues products. It gives your tools access to current Blues documentation, product expertise, and development services, including:

Notecard API documentation and request validation
The ability to search the latest Blues documentation
Expert analysis from LLM specialists with deep knowledge of Notecard, Notehub, and IoT development
Firmware development guidance for Arduino, C, Zephyr, and Python

Blues Expert is focused on building with Blues products. If you instead want to ask questions about the data your deployed devices are already sending, see the Notehub MCP server.

Installation

Blues Expert is a hosted HTTP MCP server available at:

https://mcp.blues.io/expert/mcp

Blues Expert requires no authentication and no Notehub account, so there are no API keys or tokens to configure.

To install Blues Expert, ask your AI agent to add a new HTTP MCP server using the URL above. For example:

Add a new HTTP MCP server named Blues Expert using https://mcp.blues.io/expert/mcp.

The URL is intended for MCP client configuration and will not open as a webpage in your browser.

If your AI agent cannot complete the setup automatically, choose your tool or MCP client below and follow its installation instructions:

tip

You can validate the installation of Blues Expert by asking your AI agent: "Is the Blues Expert MCP installed and available?"

Example Usage

When you're starting a new firmware project, ask your agent to scaffold the project before you ask it for anything else, for example "Start a new Notecard firmware project for Arduino." Blues Expert instructs clients to call its firmware_entrypoint tool first, because that tool returns foundational information about communicating with Notecard that improves everything the agent writes afterward.

Once you have your project created, here are some examples of how you can use the Blues Expert MCP server:

"How do I use the card.attn API? I want to use Notecard to power down my host MCU until it receives an inbound note."
"I want to write an Arduino program using Notecarrier-F, Cygnet and a BME280 sensor to measure temperature and humidity. I want to send the data to Notehub every 30 minutes."
"How can I simultaneously use the GPS and Cellular radio on my Notecard?"

MCP Tool List

Once connected, the Blues Expert MCP server exposes the following tools to your MCP client. Most clients invoke these automatically based on your prompt, but some (such as VS Code Copilot) let you call one explicitly with a #tool directive, e.g. #docs_search.

Documentation Tools

Search and reason over the latest Blues documentation.

docs_search

Search the Blues documentation for answers about Notecard, cellular connectivity, GPS, power management, Notehub, and other Notecard topics.

Example prompts:

How can I simultaneously use the GPS and Cellular radio on my Notecard?

What affects Notecard power consumption, and how do I reduce it?

Notecard API Tools

Look up and validate Notecard API requests.

api_docs

Return detailed documentation for a specific Notecard API request — parameters, types, and usage examples — or list every available API and its description.

Example prompts:

How do I use the card.attn API? I want Notecard to power down my host MCU until it receives an inbound note.

Show me the parameters for note.add.

api_validate

Validate a Notecard API request against the Notecard API schema before you use it in a firmware project.

Validation runs against the most recent release of the notecard-schema project.

Example prompts:

Is {"req":"card.temp","minutes":60} a valid Notecard request?

Validate this hub.set request for me.

Firmware Tools

Bootstrap and follow best practices for Notecard firmware projects.

firmware_entrypoint

Get a starting point for a Notecard firmware project in a given SDK: Arduino, C, Zephyr, or Python.

Blues Expert asks clients to call this tool before any of the others when writing firmware, because its response carries foundational guidance the other tools assume.

Example prompts:

Help me start an Arduino firmware project for the Notecard.

Scaffold a Zephyr application that communicates with a Notecard.

firmware_best_practices

Get best-practices guidance for firmware development by SDK and topic, such as power management, sensors, templates, connectivity, and debugging.

Example prompts:

What are the firmware best practices for power management with Notecard in C?

How should I use Note templates in an Arduino project?