---
title: Blues Expert MCP
description: A guide to installing and using the Blues Expert MCP server to build and develop Notecard and Notehub applications using generative AI.
source_url: https://dev.blues.io/tools-and-sdks/generative-ai-tools/blues-expert-mcp/
canonical_url: https://dev.blues.io/tools-and-sdks/generative-ai-tools/blues-expert-mcp/
markdown_url: https://dev.blues.io/tools-and-sdks/generative-ai-tools/blues-expert-mcp.md
---

# Blues Expert MCP

Blues Expert is a [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) (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

## Installation

Blues Expert is a hosted HTTP MCP server available at:

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

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:

- [Claude Desktop or Web](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)
- [Claude Code](https://code.claude.com/docs/en/mcp#installing-mcp-servers)
- [GitHub Copilot (VS Code)](https://code.visualstudio.com/docs/agent-customization/mcp-servers)
- [Codex](https://learn.chatgpt.com/docs/extend/mcp)
- [Cursor](https://cursor.com/docs/mcp#installing-mcp-servers)

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

## Example Usage

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 MCU host 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 the 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.

*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.

*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 the Notecard in C?

> How should I use Note templates in an Arduino project?