One balance across your workspace
The web app, Chrome extension, CLI and AI connector share your research-credit balance. Ask Adlicio to check your credits, or use whoami, before planning a larger research session.
Customer research.
Inside your AI.
Connect Adlicio to your AI app. Find real customer language, explore ad angles, and use the research you already have.
MCP connects your AI app to your Adlicio account. No API key needed.
Connect your AI app
Choose where you work. We’ll show you the setup.
- 1
Add the connector
Open Claude’s connector settings.
- 2
Connector URL
https://mcp.tryadlicio.com/mcpUse this URL for manual setup.
- 1
Use ChatGPT on the web
Open Settings and enable Developer mode.
- 2
Connector URL
https://mcp.tryadlicio.com/mcpAuthentication: OAuth.
- 1
Add a remote MCP server
Your client needs HTTP and OAuth support.
- 2
Connector URL
https://mcp.tryadlicio.com/mcpThe same endpoint for every remote client.
Check your connection
Ask your AI app:
Check my Adlicio account and remaining credits.Uses whoami · No research credits
What a successful connection looks like
Your AI returns your Adlicio account, plan, and remaining credits. If the account is wrong or the tool is missing, use the troubleshooting steps.
Next steps
Start with a real question.
You don’t need to memorize tool names. Tell your AI what you want to learn and ask it to use Adlicio.
Example research prompt1 credit per call
Research what people on Reddit find frustrating about meal planning. Show recurring problems with direct customer quotes and source links.Replace “meal planning” with your customer’s problem. Read the source quotes before turning patterns into hooks.
Connect / Claude
Connect Claude
Connect once. Use Adlicio in Claude, Desktop, and Cowork.
- Open Claude on the web and go to Customize > Connectors.
- Select +, then Add custom connector.
- Name it Adlicio and paste https://mcp.tryadlicio.com/mcp.
- Select Add, then Connect, and sign in to your Adlicio account.
- In a conversation, open + > Connectors and enable Adlicio.
Available on Free, Pro, Max, Team, and Enterprise. Free allows one custom connector. For Team and Enterprise, an Owner must add Adlicio first; each member then connects their own account.
Team & Enterprise setup
- An Owner opens Organization settings > Connectors in Claude.
- Select Add > Custom > Web, enter https://mcp.tryadlicio.com/mcp, and select Add.
- Each member opens Customize > Connectors, finds Adlicio, and selects Connect.
- Sign in with your own Adlicio account, then enable Adlicio from + > Connectors in a conversation.
Connect / ChatGPT
Connect ChatGPT
Add Adlicio as a custom app in ChatGPT on the web.
- Open Settings > Security and login and enable Developer mode.
- Open ChatGPT Plugins, select +, and create a developer-mode app.
- Name it Adlicio, enter https://mcp.tryadlicio.com/mcp, and choose OAuth.
- Complete the Adlicio sign-in and finish creating the app.
- In a new chat, open + > Developer mode and select Adlicio.
Requires Plus, Pro, Business, Enterprise, or Education with developer-mode access. Workspace permissions apply. Some workspaces use Settings > Apps > Advanced Settings and Apps > Create. Review action confirmations when prompted.
Connect / Cursor
Connect Cursor
Add a remote server to your Cursor configuration.
- Open .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects.
- Add the Adlicio entry below to mcpServers, preserving your existing servers.
- Open Customize in Cursor’s sidebar and enable Adlicio.
- Complete the Adlicio sign-in when prompted, then ask Agent to use Adlicio.
mcp.json
{
"mcpServers": {
"adlicio": {
"url": "https://mcp.tryadlicio.com/mcp"
}
}
}No API key or OAuth client secret is needed. Your organization may restrict which MCP servers you can connect. Cursor asks for tool approval according to your run settings.
Connect / Claude Code
Connect Claude Code
Register the hosted server, then sign in from Claude Code.
- From your project directory, run the command below.
- Open Claude Code and run /mcp.
- Select Adlicio and complete the sign-in flow in your browser.
- Return to /mcp and confirm Adlicio shows connected.
Terminal
claude mcp add --transport http adlicio https://mcp.tryadlicio.com/mcpThe command adds Adlicio for your current project. Add --scope user to make it available across projects. If you already connected through Claude, check /mcp before adding another configuration.
Connect / Other clients
Connect your AI app
Use a client that supports remote MCP with OAuth.
- Check that your client supports Streamable HTTP and OAuth for remote MCP servers.
- Open its custom MCP or connector settings and add a remote server.
- Name the server Adlicio and enter https://mcp.tryadlicio.com/mcp.
- Follow the client’s sign-in prompt and enable Adlicio for your conversation.
Setup labels and plan requirements vary by client. Adlicio supports dynamic OAuth client registration. Clients that only support local stdio servers need the separate CLI setup in the developer docs.
Reference
The right tool for the job.
Your AI discovers these tools automatically. Browse by task, or use search to jump to a tool. Expand a row for its inputs and details.
Cost and access are different. A tool can use zero credits and still require a paid plan. Tool availability can also depend on the connected collection service.
Research
Find and collect customer languageResearch a topic
research_topic1 creditEvery plan
Research a topic
research_topicSearch Reddit, collect matching discussions and rank customer language in one call. Use customer wording for the keyword and narrow the subreddits when the topic is broad. Add a brand to save the research to its workspace.
Inputs
Required inputs are marked.keyword- Required
brand- Optional
limit- Optional
subreddits- Optional
exclude_scraped- Optional
mode- Optional
max_comments- Optional
min_score- Optional
max_depth- Optional
sort- Optional
include_body_only- Optional
Read comments from a URL
scrape_url0–2 creditsReddit: every plan · Other sources: All Access & Team
Read comments from a URL
scrape_urlCollect comments or reviews from one supported public page. Returns customer text with its source details. The price depends on the source; stored results can be reused free. It reads a URL rather than searching for one.
Inputs
Required inputs are marked.url- Required
brand- Optional
force- Optional
mode- Optional
max_comments- Optional
max_threads- Optional
min_score- Optional
max_depth- Optional
sort- Optional
include_body_only- Optional
Find Reddit discussions
search_reddit1 creditEvery plan
Find Reddit discussions
search_redditFind relevant threads with their titles, URLs and snippets, without collecting comments. Threads already in your history include a scrape id that get_history_item can read for zero credits.
Inputs
Required inputs are marked.keyword- Required
limit- Optional
subreddits- Optional
Find YouTube videos
search_youtube0 creditsAll Access & Team
Find YouTube videos
search_youtubeFind videos with their titles, channels, views and URLs. Use a keyword of 2 to 5 words, the way a viewer types it. Returns video listings, not comments. Follow with scrape_url to read a video's comments for zero credits, or start_deep_scrape for a larger collection.
Inputs
Required inputs are marked.keyword- Required
limit- Optional
order- Optional
Find Blind discussions
search_blind1 creditEvery plan
Find Blind discussions
search_blindFind public Blind posts where professionals discuss a keyword. Returns titles, snippets, engagement and URLs, without collecting comments. Searches use the account's search allowance.
Inputs
Required inputs are marked.keyword- Required
limit- Optional
sort- Optional
Find Hacker News discussions
search_hackernews0 creditsAll Access & Team
Find Hacker News discussions
search_hackernewsFind Hacker News stories or the individual comments that match a keyword, with points, comment counts and item URLs. Follow with scrape_url on an item URL to read the whole thread for zero credits.
Inputs
Required inputs are marked.keyword- Required
limit- Optional
sort- Optional
type- Optional
Find scroll stoppers
find_scroll_stoppers3 creditsAll Access & Team
Find scroll stoppers
find_scroll_stoppersFind public TikTok and Instagram videos for a niche or competitor, ranked by engagement, with their caption hooks. These are video and hook results; use research_topic or scrape_url for the customer comments behind them.
Inputs
Required inputs are marked.keyword- Required
platform- Optional
limit- Optional
Find creators
find_creators5 creditsAll Access & Team
Find creators
find_creatorsFind TikTok and Instagram creators with followers, engagement estimates, public contact details and the posts that surfaced them. Country is a ranked preference, not a guaranteed filter. Useful for UGC, affiliates and sourcing partners.
Inputs
Required inputs are marked.keyword- Required
platform- Optional
country- Optional
minFollowers- Optional
maxFollowers- Optional
limit- Optional
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolFind Meta ads
find_competitor_ads1 creditAll Access & Team
Find Meta ads
find_competitor_adsFind Facebook and Instagram ads in the public Meta Ad Library: copy, hooks, offers, CTAs and landing URLs. Filter or sort the fetched sample by known running duration. Longevity is a research signal, not proof of profit. Limited to 25 calls a day.
Inputs
Required inputs are marked.query- Required
country- Optional
active_status- Optional
media_type- Optional
sort_by- Optional
min_days_running- Optional
cta_type- Optional
call_ads_only- Optional
keyword_only- Optional
limit- Optional
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolFind TV ad creatives
find_tv_ads3 creditsAll Access & Team
Find TV ad creatives
find_tv_adsSearch the public iSpot creative catalog for ad copy, publication dates and video links. Catalog dates do not prove when an ad aired or whether it is running. Airing times, spend and audience targeting are unavailable. Limited to 25 calls a day.
Inputs
Required inputs are marked.query- Required
limit- Optional
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolRead a Meta ad transcript
get_ad_transcript1 creditAll Access & Team
Read a Meta ad transcript
get_ad_transcriptGet the spoken transcript of one public Meta video ad using its numeric id or Ad Library URL. Transcriptions can contain errors; no on-screen text or performance is inferred. Image ads and unavailable audio cost zero credits. TV and arbitrary video URLs are unsupported.
Inputs
Required inputs are marked.ad- Required
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolRead a video transcript
get_video_transcript1 creditAll Access & Team
Read a video transcript
get_video_transcriptGet the spoken transcript of one public TikTok video, Instagram reel or YouTube video or Short by URL, with timed cues where the platform gives them. Read what a creator or competitor says: the hook, the claims, the offer and the call to action. Pair it with scrape_url on the same link for the comments under the video. Costs 1 credit when a transcript is delivered. Videos with no speech, and Instagram videos over 120 seconds, cost zero credits.
Inputs
Required inputs are marked.url- Required
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolRead a landing page
inspect_landing_page1 creditAll Access & Team
Read a landing page
inspect_landing_pageRead a public landing page's HTML copy, headings, phone links, buttons, form labels and redirects. It does not submit forms or make calls. JavaScript-only content may be missing; blocked pages are not charged. Returns page evidence, not a screenshot or performance data.
Inputs
Required inputs are marked.url- Required
Find product listings
find_products1 creditAll Access & Team
Find product listings
find_productsSearch Google Shopping for product titles, prices, merchants, ratings, review counts and URLs. Returns listings rather than review text. Use a supported product URL with scrape_url to read customer reviews.
Inputs
Required inputs are marked.query- Required
max_results- Optional
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolFind emerging products
find_early_products3 creditsAll Access & Team
Find emerging products
find_early_productsFind product listings showing early-adopter signals, with a score, supporting evidence and a signal breakdown. Search across marketplaces and customer discussions; use brand_filter and physical_only to narrow the results. An early signal is not proof a product will succeed.
Inputs
Required inputs are marked.niche- Required
marketplaces- Optional
price_min- Optional
price_max- Optional
region- Optional
strictness- Optional
brand_filter- Optional
physical_only- Optional
max_results- Optional
Availability depends on the connected collection service. Reconnect your AI app to refresh its tool list.
Link to this toolCollect more YouTube comments
start_deep_scrape3 creditsAll Access & Team
Collect more YouTube comments
start_deep_scrapeStart a background collection of available comments on one YouTube video, up to 20,000. Charged when a new job starts; an existing live job for the URL is reused without another charge. Check progress with get_deep_scrape.
Inputs
Required inputs are marked.url- Required
max_comments- Optional
force- Optional
Check a deep scrape
get_deep_scrape0 creditsAll Access & Team
Check a deep scrape
get_deep_scrapeCheck a background YouTube collection using the job id from start_deep_scrape. When it finishes, read the stored comments with get_history_item using the returned scrape id. Wait at least a minute between progress checks.
Inputs
Required inputs are marked.job_id- Required
Read a private Facebook group
scrape_facebook_group0 creditsAll Access & Team
Read a private Facebook group
scrape_facebook_groupSearch a group you belong to through your own logged-in Chrome browser. Requires the Adlicio extension with “Let Claude use this browser” enabled. Returns a background job id; get_extension_job checks progress. Public Facebook posts use scrape_url instead.
Inputs
Required inputs are marked.group_url- Required
keyword- Optional
max_posts- Optional
Check a browser collection
get_extension_job0 creditsAll Access & Team
Check a browser collection
get_extension_jobCheck a queued extension job for a Facebook group or an Amazon pull handed to your browser. Reports browser connection status and the scrape id when complete. Read the saved comments with get_history_item; wait at least a minute between checks.
Inputs
Required inputs are marked.job_id- Required
Workspace
Work with your saved researchCheck your connection and credits
whoami0 creditsEvery plan
Check your connection and credits
whoamiSee the connected Adlicio account, its plan and available research credits. A useful first connection check: it runs no research and uses no credits.
Inputs
Required inputs are marked.No inputs needed.
Link to this toolFind past research
list_history0 creditsAll Access & Team
Find past research
list_historyList saved scrapes and research from your dashboard, extension, CLI and AI chats, newest first. Filter by title, keyword or platform. Returns stored entries without collecting anything again.
Inputs
Required inputs are marked.query- Optional
platform- Optional
limit- Optional
offset- Optional
Read saved research
get_history_item0 creditsAll Access & Team
Read saved research
get_history_itemRead one stored scrape or ad inspection by its history id, without fetching it again. Set full_text to true when you need untrimmed quotes or exports. Use offset and max_comments to read longer collections in pages.
Inputs
Required inputs are marked.id- Required
full_text- Optional
max_comments- Optional
offset- Optional
Search saved comments
search_history0 creditsAll Access & Team
Search saved comments
search_historyFind a word or short phrase across comments your account already collected. Each match includes its source scrape. Searches are case-insensitive; narrow the phrase or platform when the response says more matches are available.
Inputs
Required inputs are marked.query- Required
platform- Optional
limit- Optional
Read brand research
get_brand_research0 creditsAll Access & Team
Read brand research
get_brand_researchRead a brand's avatars, ad angles, customer quotes and saved scripts. With no arguments, lists the account's brands. Also reports the status of a run started with start_brand_research.
Inputs
Required inputs are marked.brand- Optional
Create a brand workspace
create_brand0 creditsAll Access & Team
Create a brand workspace
create_brandCreate a brand in the same workspace used by the Adlicio dashboard. Its audience, offer and positioning help shape later research. An exact name that already exists returns that brand instead of creating a duplicate.
Inputs
Required inputs are marked.name- Required
url- Optional
niche- Optional
audience- Optional
offer- Optional
key_claim- Optional
tone- Optional
mechanism- Optional
Start brand research
start_brand_research3 creditsAll Access & Team
Start brand research
start_brand_researchStart the dashboard's full research pipeline for an existing brand: discussions, avatars, angles and supporting quotes. Charged when a new run starts. Usually takes 3–5 minutes; check its status with get_brand_research.
Inputs
Required inputs are marked.brand- Required
Save an ad script
save_script0 creditsAll Access & Team
Save an ad script
save_scriptSave a finished script, hook set or advertorial into a brand's Scripts library. It appears in the dashboard alongside that brand's research. Use the brand's name or id; the title is optional.
Inputs
Required inputs are marked.brand- Required
script- Required
title- Optional
See what you are monitoring
list_tracked_sources0 creditsEvery plan
See what you are monitoring
list_tracked_sourcesList the listening sources already in your workspace, with their schedule, last collection and any reported error. Filter by brand to see one workspace's targets. Reading the list does not start a collection.
Inputs
Required inputs are marked.brand- Optional
Monitor a source
add_tracked_source0 creditsPaid plans · Source limits apply
Monitor a source
add_tracked_sourceAdd a source to an existing brand for scheduled collection. Reddit targets are available on paid plans; other sources and keyword monitoring need All Access or Team. Target limits apply. Adding the target is free; later collections can use credits.
Inputs
Required inputs are marked.brand- Required
kind- Required
target- Required
cadence- Optional
Read a saved audience
get_audience0 creditsEvery plan
Read a saved audience
get_audienceRead an audience's saved sources and recent research runs. With no arguments, lists your audiences. These are the communities and pages you grouped for research, rather than a generated list of customer personas.
Inputs
Required inputs are marked.audience- Optional
Build a customer-language report
start_voc_report3 creditsEvery plan · Saved scrapes required
Build a customer-language report
start_voc_reportTurn 1–30 saved scrapes you own into a Voice-of-Customer report with themes, objections, angles and quoted evidence. Add product_context to tailor the report. Charged when a new report starts; use get_voc_report to read it when ready.
Inputs
Required inputs are marked.scrape_ids- Required
product_context- Optional
Read a customer-language report
get_voc_report0 creditsEvery plan
Read a customer-language report
get_voc_reportRead a saved Voice-of-Customer report and its status using the report id. With no arguments, lists your recent reports. Works with reports created in the dashboard or through start_voc_report.
Inputs
Required inputs are marked.id- Optional
Reference / Sources
Where the customer language lives.
Give scrape_url a supported public URL. Reddit is available on every plan; other sources require All Access or Team.
SourceCredits per delivery
YouTube
0 creditsA video URL, not a channel page.
Apple App Store
0 creditsGoogle Play
0 creditsSteam
0 creditsAliExpress
0 creditsHacker News
0 creditsStack Exchange
0 creditsIncludes Stack Overflow questions.
Product Hunt
0 creditsDiscourse forums
0 creditsDisqus comments
0 creditsNotion pages
0 creditsPublic pages only.
Reviews.io
0 creditsShopify reviews
0 creditsProduct pages using Yotpo, Loox or Judge.me.
Amazon · cache or archive
0 creditsStored or archived reviews. Have 2 credits available before starting an Amazon pull; only the delivered tier is charged.
Reddit
1 creditPublic threads and profiles. Free-plan preview limits apply.
Trustpilot
1 creditG2
1 creditQuora
1 creditBlind
1 creditLinkedIn
1 creditFacebook
1 creditPublic posts. Private groups use the browser extension workflow.
Instagram
1 creditPosts and reels. A pending result may need a later retry.
TikTok
1 creditEtsy
1 creditWalmart
1 crediteBay
1 creditProduct review pages, not individual /itm/ listings.
Better Business Bureau
1 creditSephora
1 creditUlta
1 creditTripAdvisor
1 creditphpBB forums
1 creditXenForo forums
1 creditvBulletin forums
1 creditInvision forums
1 creditAmazon · live reviews
2 creditsCharged only when the live collection tier delivers reviews.
Google Maps
2 creditsA delivered review collection costs 2 credits.
Reference / Credits
Know the cost before you start.
Research credits pay for new collection and analysis. Check your balance in your account or ask your AI to use whoami.
Zero credits and plan access are different
A tool marked 0 credits does not spend your balance. Its plan label still applies: for example, YouTube search and history reads need All Access or Team even though they use no credits.
The Free preview is a starting allowance
Free includes 6 research credits to start and a capped Reddit preview in chat. Those included credits do not reset monthly. All Access includes 250 credits a month; Team includes 750 shared credits a month. Purchased credits can affect the available allowance.
Searches charge on delivery; background jobs charge when started
Metered searches and scrapes charge when a result is delivered. Brand research, Voice-of-Customer reports and deep YouTube collections charge when a new background job starts. Their progress checks use zero credits.
Read what you already collected
History reads use zero credits. Search results flag previously collected pages with a scrape id so get_history_item can read them without collecting again. Repeating the same URL scrape within 15 minutes does not add a second charge.
Amazon charges for the tier that delivers
Have 2 credits available before starting an Amazon pull. Cache and archive results cost 0, a paid public teaser costs 1, and live reviews cost 2. The delivered result determines the charge.
Daily limits are separate from credits
All Access has daily fair-use limits of 200 Reddit searches and 150 URL scrapes. Meta ad searches and TV ad searches each have a 25-call daily limit. A remaining credit balance does not remove those limits.
Help
Get back to your research.
Start with the symptom you see. Your saved research stays in your Adlicio workspace when you reconnect.
Adlicio or its tools don’t appear
Check that Adlicio is enabled in the current conversation. Then disconnect and reconnect it in your AI app’s connector settings to refresh the tool list. In a team workspace, ask the owner whether custom connectors are enabled.
The connected account is wrong
Ask Adlicio to check your account with whoami. Disconnect the connector, then connect again and choose the same account you use in the Adlicio app.
A result says pending
Some collections run in the background. For a deep scrape, use get_deep_scrape with the returned job id. For Instagram, retry the same URL later. Brand research and Voice-of-Customer reports have their own progress tools.
A tool needs credits or a different plan
Read the response to see whether the limit is your balance, daily allowance, or plan access. Check the tool’s plan label and credit cost. A zero-credit tool may still need All Access or Team.
I need comments from a private Facebook group
Use the Adlicio Chrome extension in your own signed-in browser. The scrape_facebook_group tool queues the search; get_extension_job checks its status. Read the saved comments using get_history_item.
My AI app only supports a local server
The hosted connector needs remote HTTP support. Use the commentscraper CLI’s local stdio MCP setup instead. It is a separate integration, described in the developer docs.
Technical details
One hosted connection.
- Endpoint
https://mcp.tryadlicio.com/mcp- Transport
- Streamable HTTP
- Authentication
- OAuth 2.1 with PKCE. Sign in with your Adlicio account.
- Client registration
- Dynamic registration. No client ID to request.
For local MCP, the CLI, REST API, and webhooks, read the developer documentation. You can disconnect Adlicio from your AI app at any time and revoke authorized devices in your account.