My agent does not see any Listadum tools

Check that the server URL is exactly https://mcp.listadum.com, with nothing after it. Then make sure the connector is turned on for the chat, and reload the connector or restart your agent.

Sign-in works, but my agent gets an access error

Your Listadum account needs API access: it is included with Max and available as an add-on on Starter and Growth. Once it is on, disconnect and reconnect Listadum in your agent.

My agent sees the wrong shops

Your agent uses the Listadum account you signed in with. Disconnect Listadum in your agent, sign out of Listadum in your browser, then connect again with the right account.

My agent says it hit a rate limit

The MCP server shares rate limits with the Listadum API, which keeps a runaway agent from flooding your shop. Wait a moment before retrying, and ask your agent to work in smaller batches instead of looping over everything at once.

How do I disconnect my agent?

Remove Listadum from your agent connectors or MCP settings. Your agent loses access to your shops right away.

AI agents

Connect your AI agent to your Etsy shops via Listadum in minutes

One URL, one sign-in, and your agent can read your listings, check keywords and fix what holds your shop back. Pick your agent and follow along.

Listadum MCP server URL

https://mcp.listadum.com

This is the only address your agent needs. No API key to paste, you sign in with your Listadum account.

Jump to your agent

Claude
ChatGPT
Grok
Meta Muse
Dots
Hermes
OpenClaw

Before you start

Three things, and you probably have two of them already.

Your Etsy shop on Listadum

Your agent works on the shops connected to your Listadum account, so connect at least one first.

An agent that speaks MCP

Any agent that supports remote MCP servers works, including every agent in this guide.

A plan with API access

API access is included with Max. On Starter or Growth, add it for $10/mo.

See plans

Step by step, for your agent

Each agent has its own menus. The idea is always the same: add the Listadum URL, then sign in.

Claude

Web, desktop and Claude Code

1
In Claude on the web or the desktop app, open Settings, then Connectors.
2
Click Browse connectors, search for Listadum and click Connect. Not listed for you? Choose Add custom connector, name it Listadum and paste https://mcp.listadum.com.
3
Sign in to Listadum and approve access. Listadum now shows in the tools menu of every new chat.

Using Claude Code?

Run this command in your terminal, then type /mcp in Claude Code and pick listadum to sign in.

claude mcp add --transport http listadum https://mcp.listadum.com

Connectors you add on the web also show up in the Claude desktop and mobile apps.

ChatGPT

Web and desktop

1
Open Settings, then Apps, then Advanced settings, and turn on Developer mode.
2
Click Create app. Name it Listadum, paste https://mcp.listadum.com as the server URL and choose OAuth for authentication.
3
Sign in to Listadum and approve access.
4
In a new chat, add Listadum from the + menu before you ask your question.

Use a Thinking model rather than Instant: it calls tools more reliably. No Developer mode in your settings? Your ChatGPT plan or workspace may not allow custom apps yet.

Grok

grok.com

1
Go to grok.com/connectors and click New Connector.
2
Choose Custom, name it Listadum and paste https://mcp.listadum.com as the server URL.
3
Sign in to Listadum and approve access. Grok picks up the Listadum tools right away.

Custom connectors need a paid Grok plan. On Grok Business or Enterprise, an admin may need to enable them first.

Meta Muse

Meta AI app and web

1
Start a new chat and ask Muse to create the connector:
Create a custom connector named Listadum for https://mcp.listadum.com using streamable HTTP, with OAuth sign-in.
2
Open the sign-in link Muse sends you, sign in to Listadum and approve access.
3
Ask Muse to list your Etsy shops. If it can, you are connected, and Muse remembers the connector in future chats.

You can also add it from Settings, then Connectors, then Add custom connector.

Dots

App

1
Open your Dot, go to its connections and add a custom MCP connection named Listadum with https://mcp.listadum.com.
2
Sign in to Listadum and approve access.
3
Ask your Dot to list your Etsy shops to make sure it can see them.

If your Dot runs in ChatGPT, it can use the apps on your ChatGPT account: follow the ChatGPT steps above and your Dot gets Listadum too.

Hermes

Config file

1
Add Listadum under mcp_servers in ~/.hermes/config.yaml:
```
mcp_servers:
  listadum:
    url: https://mcp.listadum.com
```
2
Run /reload-mcp in your Hermes session, or restart Hermes.
3
Sign in to Listadum when Hermes opens the sign-in page, then approve access.

Want a read-only agent? Use the tools key in the same config to limit which Listadum tools Hermes can call.

OpenClaw

Terminal

Add Listadum as a Streamable HTTP server and sign in:

openclaw mcp add listadum --url https://mcp.listadum.com --transport streamable-http
openclaw mcp login listadum

2
Follow the sign-in link printed in your terminal, sign in to Listadum and approve access.
3
Run openclaw mcp doctor listadum --probe to confirm OpenClaw can reach Listadum.

Prefer clicking? Open the Control UI, go to Settings, then MCP, and add a server with the Streamable HTTP transport.

Any other MCP agent

Remote HTTP

1
Add a remote HTTP (Streamable HTTP) server with the Listadum URL. If your agent uses a JSON config, it looks like this:
```
{
  "mcpServers": {
    "listadum": {
      "type": "http",
      "url": "https://mcp.listadum.com"
    }
  }
}
```
2
Restart or reload your agent, then sign in to Listadum when it asks.

Check that it works

Send one of these to your agent. If it answers with your real shop data, you are all set.

What Listadum tools can you use?

List my Etsy shops on Listadum.

Which of my listings should I fix first, and why? Show me the numbers.

Good habits from day one

Your agent can change real listings. A little care goes a long way.

Keep approvals on

Most agents ask before running an action that changes your shop. Leave that on until you trust the workflow.

Ask before you edit

Start with questions about your shop, then move to edits on a few listings before going bulk.

Ask for the numbers

Have your agent show demand and competition behind each keyword it suggests, so you can check its work.

Troubleshooting

: Check that the server URL is exactly https://mcp.listadum.com, with nothing after it. Then make sure the connector is turned on for the chat, and reload the connector or restart your agent.
: Your Listadum account needs API access: it is included with Max and available as an add-on on Starter and Growth. Once it is on, disconnect and reconnect Listadum in your agent.
: Your agent uses the Listadum account you signed in with. Disconnect Listadum in your agent, sign out of Listadum in your browser, then connect again with the right account.
: The MCP server shares rate limits with the Listadum API, which keeps a runaway agent from flooding your shop. Wait a moment before retrying, and ask your agent to work in smaller batches instead of looping over everything at once.
: Remove Listadum from your agent connectors or MCP settings. Your agent loses access to your shops right away.

Keep going

What agents can do

Capabilities, example prompts and workflows for your shop.

API Access

The add-on behind agent access, for scripts and custom tools too.

API documentation

Interactive reference with every endpoint, request and response.

No Listadum account yet?

Start here, connect your agent next

Connect your Etsy shop to Listadum, then come back to this guide and add one URL to your agent.

Get started