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

# Connect AI Agents (MCP)

Famewall can plug straight into the AI assistants you already use. 

Once connected, you can ask **Claude** or **ChatGPT** things like *"show me my newest testimonials"* or *"add this 5-star review to my homepage wall"* and it happens, without you opening the dashboard.

You can also connect your own **autonomous agent** (an AI that runs on its own, like an n8n workflow or a script) so it can work with your testimonials around the clock.

{% hint style="info" %}
**What is MCP?** MCP (Model Context Protocol) is the standard way that AI assistants connect to outside tools. You don't need to understand how it works. Think of it as a secure doorway that lets your AI assistant talk to your Famewall account. You stay in control of what it's allowed to do, and you can disconnect at any time.
{% endhint %}

## What you'll need

* A Famewall account on a **paid plan** (AI agent access is a paid feature).
* One AI assistant: **Claude**, **ChatGPT**, or your own agent.
* **2–3 minutes.** No code required for Claude or ChatGPT.

## Your Famewall MCP address

Everything connects using one web address. This is the only value you'll ever need to paste:

```
https://api.famewall.io/mcp
```

You can copy it straight from the **Connect AI Agents** page in your Famewall dashboard (there's a **Copy URL** button next to it).

## Connect your AI

Pick the assistant you use. Claude and ChatGPT sign you in securely with your Famewall account — there's **no key to copy or paste**.

{% tabs %}
{% tab title="Claude" %}
**Takes about 2 minutes.** Works on Claude on the web and the Claude desktop app.

1. Open **Claude** and go to **Settings → Connectors**.
2. Click **Add custom connector**.
3. When Claude asks for the connector URL, paste your Famewall address:

   ```
   https://api.famewall.io/mcp
   ```
4. Click **Connect**, sign in with your **Famewall** account, and pick what Claude is allowed to do.
5. You're connected! Open any chat and just ask it to work with your testimonials.

{% hint style="success" %}
**Try this first:** *"Show me my 5 most recent testimonials."*
{% endhint %}
{% endtab %}

{% tab title="ChatGPT" %}
**Takes about 3 minutes.** Connectors live in ChatGPT's settings.

1. In **ChatGPT**, turn on **Developer mode**, then open **Settings → Connectors**.
2. Add a new connector and choose **"MCP server"**.
3. Paste your Famewall address as the **server URL**:

   ```
   https://api.famewall.io/mcp
   ```
4. Continue, then **sign in with your Famewall account** to authorize it.
5. You're connected! Ask ChatGPT to pull up or add testimonials for you.

{% hint style="success" %}
**Try this first:** *"What submissions are waiting for me to review in Famewall?"*
{% endhint %}
{% endtab %}

{% tab title="Autonomous agent" %}
For AI agents that run on their own, 24/7 — tools like **n8n**, the **OpenAI Agents SDK**, the **Claude Agent SDK**, and your own scripts built on the MCP SDK.

Because these agents can't click a "Sign in" button, they authenticate with a **secret key** instead.

1. **Point your agent at the Famewall MCP address:**

   ```
   https://api.famewall.io/mcp
   ```
2. **Generate a secret key.** On the **Connect AI Agents** page in Famewall, open the **Autonomous agent** tab and click **Generate Key**. Your key starts with `fw_ag_`. Copy it now as it's only shown once.
3. **Send that key as a Bearer token on every request:**

   ```
   Authorization: Bearer fw_ag_your_key_here
   ```

{% hint style="warning" %}
**Keep this key server-side.** Anyone who has it can act on your Famewall account. Never put it in browser code, a public repository, a screenshot, or anywhere a person could copy it.
{% endhint %}
{% endtab %}
{% endtabs %}

## Try it: first prompts to type

Not sure where to start? Paste any of these into your connected assistant:

* *"Show me my 5 most recent testimonials."*
* *"Add a 5-star testimonial from Jane Doe that says 'Best tool I've used all year.'"*
* *"Search my testimonials for anything that mentions 'support'."*
* *"How many testimonials do I have in total?"*
* *"What submissions are waiting for me to review?"*
* *"Fix the typo in that testimonial and update the author's job title."*
* *"Rename my 'default' wall to 'Customer Love'."*

Your assistant will always tell you what it did and confirm it back to you.

## What it can do once connected

Your AI assistant can help with four kinds of tasks. You choose which of these to allow when you connect (see [Choosing what it can access](#choosing-what-it-can-access)).

**📖 Look things up**

* Pull up your latest testimonials, or open a specific one.
* Search across your testimonials by keyword, wall, star rating, or type.
* Get a quick count of your walls, testimonials, and pending submissions.

**➕ Add testimonials by chat**

* Paste a customer's words and have them added to the right wall — formatted and attributed, with a rating and links if you have them.

**✏️ Tidy up wording**

* Fix a typo, polish an author's job title, or correct a link on an existing testimonial.
* Rename a wall or update its description.

**📥 Check what's waiting**

* See the submissions that came in through your collection form, so you know what's ready for you to review.

### Full list of abilities

For the technically curious, here's everything the assistant can do, with the exact tool name and the permission each one needs:

| Plain-English action                                  | Tool                         | Permission needed       |
| ----------------------------------------------------- | ---------------------------- | ----------------------- |
| List your walls                                       | `list_walls`                 | View your walls         |
| Open one wall (with its testimonial count)            | `get_wall`                   | View your walls         |
| List testimonials on a wall                           | `list_testimonials`          | Read your testimonials  |
| Open one testimonial                                  | `get_testimonial`            | Read your testimonials  |
| Search testimonials by text, wall, rating or type     | `search_testimonials`        | Read your testimonials  |
| Count walls, testimonials & pending submissions       | `get_account_usage`          | View account insights   |
| See submissions waiting for review                    | `list_collected_submissions` | View submissions        |
| Add a text testimonial to a wall                      | `add_text_testimonial`       | Add & edit testimonials |
| Edit a testimonial's wording, author, rating or links | `update_testimonial`         | Add & edit testimonials |
| Rename a wall or change its description               | `update_wall_settings`       | Edit your walls         |

## Choosing what it can access

When you connect Claude or ChatGPT, Famewall shows you a permissions screen. **Tick only what you need** — you can always allow more later. Each permission unlocks a group of abilities:

| Permission                  | What it lets your assistant do                        |
| --------------------------- | ----------------------------------------------------- |
| **View your walls**         | See your walls of love and their settings.            |
| **Read your testimonials**  | Browse and search the testimonials you've collected.  |
| **View submissions**        | See responses waiting from your collection forms.     |
| **View account insights**   | Read your usage, plan, and account stats.             |
| **Add & edit testimonials** | Create new testimonials and tidy up existing wording. |
| **Edit your walls**         | Update wall names and descriptions.                   |

{% hint style="info" %}
You may also see options for features that are still rolling out (like reviewing submissions). Leave those unticked if you don't need them yet.
{% endhint %}

## Managing your autonomous agent key

Your `fw_ag_` key only matters for the **Autonomous agent** option. Claude and ChatGPT never use one. From the **Connect AI Agents** page you can:

* **Regenerate** the key — this creates a fresh key and **immediately stops the old one from working**. Update your agent with the new key afterward.
* **Revoke** the key — this permanently switches off autonomous access until you generate a new key.

Regenerate if you think a key may have leaked; revoke if you want to shut off an agent entirely.

## Rate limits

There's a fair-use limit of roughly **120 requests per minute** per connection. If an assistant goes over it, requests return a rate-limit error - just wait a minute and try again. Normal chatting will never come close to this.

## Troubleshooting

### I can't find where to add a connector

* **Claude:** Custom connectors live under **Settings → Connectors → Add custom connector**. If you don't see it, make sure your Claude app is up to date.
* **ChatGPT:** You must turn on **Developer mode** first, then connectors appear under **Settings → Connectors**.

### It asks me to sign in again, or says "unauthorized"

Your secure session with Famewall expired. Reconnect the connector and sign in again. It only takes a moment.

### My autonomous agent gets an "unauthorized" error

* Make sure you're sending the key as `Authorization: Bearer fw_ag_...` with **no extra spaces**.
* If you recently **regenerated** or **revoked** the key, the old one no longer works - generate a new key and update your agent.

### I hit a rate-limit error

You're sending requests too quickly. Wait about a minute and try again.

### Nothing happens / it says I need to upgrade

AI agent access is available on **paid Famewall plans**. Upgrade from the pricing page, then connect again.

## Related docs

{% content-ref url="/pages/fX8c8AfsYmKhqjBWM7wr" %}
[API Guide](/api-guide.md)
{% endcontent-ref %}

{% content-ref url="/pages/L5yHAT6FOplSG5xFQOay" %}
[Zapier Integration](/zapier-integration.md)
{% endcontent-ref %}

{% content-ref url="/pages/HHGyRpucaf8eJlwMjijj" %}
[Webhook Integration](/webhook-integration.md)
{% endcontent-ref %}

{% content-ref url="/pages/U3DF7mtstP8dVR3rdcFn" %}
[Make.com Integration](/make-com-integration.md)
{% endcontent-ref %}