> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/fuul-mcp-server/quickstart.md).

# Quickstart

The Fuul MCP (Model Context Protocol) server lets you manage your Fuul programs directly from AI coding assistants like Claude Code. Once connected, your AI agent can query affiliate analytics, inspect incentive programs, manage payouts, and send conversion events.

{% hint style="info" %}
MCP is an open standard that lets AI assistants connect to external tools and APIs. The Fuul MCP server implements this protocol so any MCP-compatible client can interact with your Fuul account.
{% endhint %}

## What you can do

| Capability                  | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| Query projects & incentives | List programs, view and edit triggers, and review conversion setups |
| Affiliate analytics         | Get stats breakdowns by audience, tier, region, or status           |
| Manage payouts              | Review pending payouts and approve or reject in bulk                |
| Send events                 | Trigger custom conversion events for testing or automation          |
| Managed affiliates          | Create and update affiliate records programmatically                |

## Quickstart

This guide walks you through connecting the Fuul MCP server to Claude Code in three steps.

{% hint style="info" %}
These steps require [Claude Code](https://claude.ai/code) installed and running. The Fuul MCP server works with any MCP-compatible AI client, but the installation commands below are specific to Claude Code.
{% endhint %}

### 1. Add the marketplace

In Claude Code, add the Kuyen Labs marketplace — this is the registry that hosts the Fuul MCP plugin:

```
/plugin marketplace add kuyen-labs/mcp_server
```

### 2. Install the Fuul MCP plugin

Once the marketplace is added, install the plugin:

```
/plugin install fuul-mcp@fuul-mcp
```

### 3. Log in to your Fuul account

Run the login command from your terminal:

```bash
npx -y --package=@fuul/mcp-server@latest fuul-mcp login
```

When prompted for the API URL, enter:

```
https://api.fuul.xyz/
```

A browser window will open for OAuth authentication. Sign in with your Fuul account — the same credentials you use at [app.fuul.xyz](https://app.fuul.xyz).

{% hint style="success" %}
Once authenticated, your session token is stored at `~/.fuul/tokens.json` (Windows: `%USERPROFILE%\.fuul\tokens.json`). The MCP server reads this file automatically on every request — you only need to log in once.
{% endhint %}

### Verify the connection

Back in Claude Code, ask it to find your project:

> "Find my project called \[your project name]"

If the connection is working, Claude will return your project details directly from the Fuul API.

{% hint style="warning" %}
If you get a 401 error, your session may have expired. Re-run the login command from step 3 to refresh your token.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fuul.xyz/fuul-mcp-server/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.