MCPFor Claude, ChatGPT and Cursor


Ask your assistant to find listicles with open spots, request a spot, propose a swap or tell you what waits on you. It works on your own account, and nothing that spends credits runs before you confirm.

Get startedConnect an app
Server URLhttps://www.aylistcle.com/api/mcp/mcp
  • Claude
  • ChatGPT
  • Claude Code
  • Cursor
What it does

MCP is how AI apps call outside tools. Ours gives your assistant the actions you have in the app: search other members' listicles, check your credits, request a spot, answer a swap. You type what you want and the assistant picks the tool.

More things to ask
  • What's waiting on me this week?
  • Add these 12 listicle URLs from my blog.
  • Propose a swap to the host of the second one.
An AI assistant drops a blue card into an open spot on a man's list
Example chat

Find cold email listicles with an open spot and DR over 50.

search_listiclesfield: cold email, dr_min: 50

I found 3 with an open spot. The first fits your product best.

  • salesgrowthlab.comDR 64 · spot #7 open120 cr
  • outboundweekly.comDR 58 · spot #4 open95 cr
  • inboxcraft.devDR 52 · spot #9 open70 cr

Request a spot on the first one.

request_inclusionPreview

It costs 120 credits and leaves you 280. The host approves it before anything is final. Go ahead?

ConfirmNothing is spent until you confirm.
Tools

Lists return 20 items by default and take limit (up to 50) and offset. Search returns 24 per page, like the Search page.

Account

3 tools
A person in a circle with a coin
  • list_products

    Your products and whether Search Console is connected.

  • add_product

    Add a product by its domain. Up to 5.

  • get_credits

    Spendable, held and pending credits.

Your listicles

5 tools
A ranked list with one blue row
  • list_my_listicles

    The listicles you own for a product.

  • get_listicle

    Entries, open spots, DR, impressions, position and price.

  • add_listicles

    Add up to 50 of your listicle pages at once.

  • list_suggested_listicles

    Listicles we found on your own site.

  • add_suggested_listicle

    Add one of those suggestions.

Discover

3 tools
A magnifying glass with a sparkle
  • search_listicles

    Search members' listicles by words, field, DR, open spots and more.

  • search_companies

    The same search, grouped by company.

  • explore_feed

    Open spots, new this week, rising on Google, companies to watch.

Deals

6 tools
A blue card and an orange card swapping places
  • list_deals

    Swaps and inclusion requests, with status and whose turn it is.

  • whats_waiting

    What waits on you, most urgent first.

  • request_inclusion

    Ask a host to include your product. Spends credits.Needs confirm

  • propose_swap

    Ask for a swap. Spends no credits, emails the other member.Needs confirm

  • answer_request

    Accept, decline or cancel a swap or inclusion.Needs confirm

  • mark_mention_added

    Tell us a mention is live so the crawler checks it.

Inbox

1 tool
An inbox tray with a new letter
  • read_inbox

    Swap and inclusion updates, new requests and failed checks.

Connect

Apps that support sign-in connect with the URL alone. Everything else takes a personal token you make in Settings.

Sign in

  • Claude
  • ChatGPT
  • Claude Code
  1. 1Add the server URL as a connector. In Claude: Settings, Connectors, Add custom connector. ChatGPT starts the sign-in itself once you add the URL.
  2. 2Sign in to AY Listicle and pick what the app may do: See, Change, or Spend and answer.
  3. 3Ask in plain words. Revoke the app in Settings any time.
Claude Code: add it, then run /mcp and pick Authenticate
claude mcp add --transport http aylistcle \
  https://www.aylistcle.com/api/mcp/mcp

Use a token

  • Cursor
  • Claude
  • Claude Code
  1. 1Sign in, open Settings, then AI assistants (MCP). Name a token and press Create token.
  2. 2Copy it right away. We show it once and keep only its hash.
  3. 3Paste the snippet for your app below and swap ayl_your_token for your token.
URL
https://www.aylistcle.com/api/mcp/mcp
Header
Authorization: Bearer ayl_your_token

Cursor

Paste into ~/.cursor/mcp.json, or .cursor/mcp.json in a project.

{
  "mcpServers": {
    "aylistcle": {
      "url": "https://www.aylistcle.com/api/mcp/mcp",
      "headers": { "Authorization": "Bearer ayl_your_token" }
    }
  }
}

Claude Desktop

Settings, Developer, Edit Config, then paste into claude_desktop_config.json and restart. Needs Node.js, because the config file reaches the server through mcp-remote.

{
  "mcpServers": {
    "aylistcle": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote@0.15.2",
        "https://www.aylistcle.com/api/mcp/mcp",
        "--header", "Authorization:${AYL_AUTH}"
      ],
      "env": { "AYL_AUTH": "Bearer ayl_your_token" }
    }
  }
}

Claude Code

Run this in your terminal to use a token instead of signing in.

claude mcp add --transport http aylistcle \
  https://www.aylistcle.com/api/mcp/mcp \
  --header "Authorization: Bearer ayl_your_token"
Safety

What an app may do

When you sign an app in, you pick its permissions on our consent page.

  • SeeProducts, listicles, credits, deals, inbox and search. Always on.
  • ChangeAdd products and listicles, and mark a mention as added.
  • Spend and answerRequest inclusions, propose swaps and answer requests. Each still shows a preview first.
  • A connection acts as you and sees only your products, deals and credits.
  • Each token gets 120 tool calls a minute.
  • No payments over MCP. You buy credits in the app.

The confirm step

Three tools spend credits or answer someone: request_inclusion, propose_swap and answer_request. The first call only returns a preview. The second call, with confirm: true, does it.

A finger about to press a confirm button next to a receipt and coins
Example preview, shortened
{
  "confirm_required": true,
  "action": "Request inclusion (spends credits)",
  "details": {
    "product": "Your product",
    "cost_credits": 120,
    "balance": 400,
    "balance_after": 280,
    "host_earns_credits": 84
  },
  "note": "Nothing happened yet. Call this again with confirm: true to go ahead."
}
WebMCP

WebMCP lets an AI agent in your browser use the page you have open. In a browser that supports it, such as Chrome's early preview, AY Listicle's pages hand the agent these tools. No token, no setup. Browsers without WebMCP see nothing new.

Signed out

On the public pages. Read only, and nothing about other members' listicles.
  • search_blog

    Find blog posts by words in the title or excerpt.

  • get_post

    Read one post in markdown.

  • get_pricing

    The plan, its credits and what a spot costs.

  • how_ay_listicle_works

    Matching, swaps, credits and the crawler check.

  • start_signup

    Open the sign-up page. You fill it in and send it.

Signed in

In the app, as you, with the session you're signed in with. Same names and inputs as the MCP tools.
  • list_products, get_credits

    Your products and your credits.

  • list_my_listicles, get_listicle

    Your listicles, or one listicle in full.

  • search_listicles, explore_feed

    Members' listicles. Locked rows without a plan, as in the app.

  • list_deals, whats_waiting, read_inbox

    Your deals, what waits on you and your inbox.

  • request_inclusion, propose_swap, answer_request

    The preview opens in the page. Nothing happens until you press Confirm.You confirm

FAQ

Which apps can I use?

Claude (claude.ai, Claude Desktop and mobile), ChatGPT and Claude Code connect by signing in. Cursor, Claude Desktop's config file and any app that sets a header work with a token. The server speaks Streamable HTTP at one URL.

Do I need a plan?

You need an AY Listicle account to connect. Without a plan, search and the feed show each listicle's numbers (DR, price, open spots) but not its name, link or entries. Requesting a spot spends credits, which come with a plan.

Can the assistant spend my credits without asking?

No. request_inclusion, propose_swap and answer_request first return a preview with the cost and your balance after. Nothing happens until the tool is called again with confirm: true, and most apps show you that call before it runs. An app you signed in also needs the Spend and answer permission.

Can an agent in my browser use AY Listicle without a token?

Yes, in a browser with WebMCP, such as Chrome's early preview. The page you have open hands the agent its tools. Signed out it can read the blog and pricing. Signed in it acts as you, and anything that spends credits or answers someone waits for you to press Confirm in the page.

How do I disconnect an app?

Open Settings, then AI assistants (MCP). Revoke a connected app or a token there and it stops working on its next call. We store only hashes of tokens, so we can't show a token to you again either.

Where can I see every tool's inputs?

Your app lists them once it connects. Each tool describes its inputs and returns JSON. Lists return 20 items by default and take limit (up to 50) and offset.

Get started