> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nudget.app/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Setup

> Use Nudget from your AI tools

# MCP Server Setup

Nudget provides a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server. Manage your subscriptions, content, and digests directly from AI tools like Claude Desktop, Claude Code, Cursor, and more.

## Prerequisites

1. You need a Nudget account.
2. Generate an **API Key** on the Settings page. ([API Key Guide](/guides/api-keys))

## Configuration

Add the following to your MCP client's config file:

<CodeGroup>
  ```json Claude Desktop (claude_desktop_config.json) theme={null}
  {
    "mcpServers": {
      "nudget": {
        "type": "http",
        "url": "https://nudget.app/api/mcp",
        "headers": {
          "X-API-Key": "YOUR_API_KEY"
        }
      }
    }
  }
  ```

  ```json Claude Code (.mcp.json) theme={null}
  {
    "mcpServers": {
      "nudget": {
        "type": "http",
        "url": "https://nudget.app/api/mcp",
        "headers": {
          "X-API-Key": "${CONTENTS_HUB_API_KEY}"
        }
      }
    }
  }
  ```
</CodeGroup>

<Tip>
  In Claude Code, use the `${CONTENTS_HUB_API_KEY}` environment variable to avoid exposing your API key in config files.
</Tip>

## Available Tools

### Subscription Management

| Tool                        | Description                                                |
| --------------------------- | ---------------------------------------------------------- |
| `list_subscriptions`        | List all subscriptions (URL, type, status, last checked)   |
| `get_subscription_contents` | Get collected content for a subscription (with pagination) |

### Content

| Tool                 | Description                                               |
| -------------------- | --------------------------------------------------------- |
| `list_content_items` | List all content items (filter by subscription or status) |
| `get_content_item`   | Get detailed content info (including full text)           |

### Briefings

| Tool                       | Description                                              |
| -------------------------- | -------------------------------------------------------- |
| `list_briefings`           | List briefings (with pagination)                         |
| `get_today_briefing`       | Get today's briefing                                     |
| `get_briefing`             | Get a specific briefing in detail                        |
| `submit_briefing_feedback` | Submit feedback on a briefing (thumbs up/down + comment) |

### Lens Management

| Tool          | Description                            |
| ------------- | -------------------------------------- |
| `list_lenses` | List all lenses                        |
| `create_lens` | Create a lens (name + optional detail) |
| `delete_lens` | Delete a lens                          |

## Usage Examples

With MCP connected, you can use Nudget with natural language in your AI tools:

* "Show me today's digest"
* "Add an AI lens"
* "List the content collected from my YouTube subscriptions"
* "Leave a thumbs up on this week's digest"