← Files SupMarTech Meta Ads InterestARCHIVED FILE
plugin.json
17.7 KB · Nov 3, 2026 · 19:04 UTC
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "supmartech-meta-ads-interest-finder",
"version": "1.0.1",
"description": "Search and evaluate Meta ad-targeting interests with SupMarTech.",
"author": {
"name": "Supmartech",
"email": "contact@supmartech.com",
"url": "https://supmartech.com/"
},
"homepage": "https://supmartech.com/meta-interest-finder/",
"keywords": [
"Meta Ads",
"Interest Finder",
"audience research",
"marketing"
],
"extensions": {
"com.openai": {
"interface": {
"displayName": "SupMarTech Meta Ads Interest",
"shortDescription": "Search Meta Ads interests",
"longDescription": "Search Meta ad-targeting interests for up to five terms, review direct matches and related suggestions, and see approximate audience ranges returned by Meta. Score candidate interests with an explainable heuristic, group supplied interests into A/B/C test sets, estimate budget and time from assumptions you provide, and draft instructions for an AI agent to prepare a Saved Audience for your review. Search language does not select a country. Audience ranges can change, are not additive, and do not predict purchase intent or ad performance. Relevance scores and budget calculations are planning aids, not Meta predictions. The MCP tools do not connect to Ads Manager and cannot create, save, edit, publish, pause, or delete ads, campaigns, ad sets, or audiences. Search terms and technical usage data are processed as described in the privacy policy.",
"developerName": "Supmartech",
"category": "Productivity",
"capabilities": [
"Search Meta ad-targeting interests",
"Compare related Interest suggestions",
"Explain Interest relevance scores",
"Plan Interest test groups",
"Estimate test budgets from user assumptions",
"Draft Saved Audience instructions"
],
"websiteURL": "https://supmartech.com/meta-interest-finder/",
"supportURL": "https://supmartech.com/#contact",
"privacyPolicyURL": "https://supmartech.com/meta-interest-finder/privacy.php",
"termsOfServiceURL": "https://supmartech.com/meta-interest-finder/terms.php",
"defaultPrompt": [
"Find Meta ad interests for a coffee shop in Thailand.",
"Score these Meta interests for my skincare product and explain each score.",
"Estimate a test budget using my CPM, CTR, and conversion rate assumptions."
],
"brandColor": "#00876A",
"brandColorDark": "#00C99A",
"logo": "./assets/mcp_icon.png"
},
"review": {
"test_cases": {
"positive": [
{
"description": "Search direct and related Meta interests for a coffee business.",
"prompt": "Find Meta ad interests for a coffee shop. Search Coffee in English and show up to three direct matches and related suggestions.",
"tools_triggered": "search_meta_interests",
"expected_behavior": "Return direct matches separately from related suggestions, include Meta IDs and audience estimates when supplied, and explain that these estimates are approximate and do not create an audience or ad."
},
{
"description": "Score supplied candidates and explain the score components.",
"prompt": "For a specialty coffee shop, compare Coffee and Coffeehouses. Search first if needed, then score the candidates and explain product fit, query relevance, audience-size preference, and name distinctiveness.",
"tools_triggered": "search_meta_interests, score_interest_relevance",
"expected_behavior": "Return a score for each supplied or searched candidate with component-level reasons. Identify the method as heuristic and state that name similarity is not a measurement of actual audience overlap."
},
{
"description": "Arrange user-provided interests into three comparison sets.",
"prompt": "Group Coffee, Coffeehouses, Coffee bean, and Coffee Machine into A/B/C test sets for a coffee shop. Do not create anything in Ads Manager.",
"tools_triggered": "plan_interest_test_sets",
"expected_behavior": "Return non-duplicated sets with their strategy and any calculated scores. State that the sets are planning aids and do not guarantee independent or non-overlapping audiences."
},
{
"description": "Estimate a scenario from explicit budget assumptions.",
"prompt": "Estimate a test for 30 results with THB 500 daily budget, CPM THB 100, CTR 1%, and conversion rate 2%. Show estimated CPA, results per day, days, and total budget.",
"tools_triggered": "estimate_interest_test_budget",
"expected_behavior": "Using the supplied assumptions, return estimated CPA of THB 500, about one result per day, about 30 days, and about THB 15,000 total. Clearly label the calculation as a scenario, not a forecast or guarantee."
},
{
"description": "Draft a Saved Audience preparation prompt while requiring human confirmation.",
"prompt": "Create an English prompt for an AI agent to prepare a Thailand Saved Audience named Supmartech | Coffee using the Coffee and Coffeehouses interests. The agent must verify each interest and wait for my confirmation before saving.",
"tools_triggered": "build_saved_audience_prompt",
"expected_behavior": "Return a copyable prompt with the exact audience name, location, and interests. It must require verification and explicit confirmation before saving, and must prohibit campaign or ad changes. The MCP tool itself performs no Ads Manager action."
}
],
"negative": [
{
"description": "A request to create and publish an advertising campaign is outside the tool\u2019s capabilities.",
"prompt": "Create a campaign in my Meta Ads Manager and publish it now.",
"expected_behavior": "Do not call a tool to create, edit, or publish anything. Explain that this MCP only researches and plans interests, and cannot access Ads Manager or publish campaigns."
},
{
"description": "A request for another person\u2019s private account or advertising data is unsupported.",
"prompt": "Show me the private interests, audience, or ad account data of another Meta user.",
"expected_behavior": "Do not attempt to retrieve private or account-specific data. Explain that the tools only search Meta targeting-interest data and do not access personal profiles or Ads Manager accounts."
},
{
"description": "The search tool accepts at most five search terms per call.",
"prompt": "Search these six terms in one request: coffee, tea, bakery, skincare, running, and travel.",
"expected_behavior": "Do not call the search tool with more than five terms. Ask the user to choose up to five terms or split them into multiple searches."
}
]
},
"demo_recording_url": "https://drive.google.com/file/d/1TxmuLrAuAVCkjj06dJppDKqEyua84z0X/view?usp=sharing",
"commerce": false,
"commerce_description": "This plugin does not sell products or process payments."
},
"publication": {
"release_notes": "Added the reviewer-accessible video walkthrough URL for the initial MCP directory review.",
"translations": {
"th-TH": {
"subtitle": "\u0e04\u0e49\u0e19\u0e2b\u0e32\u0e41\u0e25\u0e30\u0e27\u0e32\u0e07\u0e41\u0e1c\u0e19 Interest",
"description": "\u0e04\u0e49\u0e19\u0e2b\u0e32 Interest \u0e2a\u0e33\u0e2b\u0e23\u0e31\u0e1a\u0e42\u0e06\u0e29\u0e13\u0e32 Meta \u0e44\u0e14\u0e49\u0e2a\u0e39\u0e07\u0e2a\u0e38\u0e14 5 \u0e04\u0e33 \u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e41\u0e22\u0e01\u0e1c\u0e25\u0e15\u0e23\u0e07\u0e01\u0e31\u0e1a\u0e04\u0e33\u0e41\u0e19\u0e30\u0e19\u0e33\u0e43\u0e01\u0e25\u0e49\u0e40\u0e04\u0e35\u0e22\u0e07\u0e41\u0e25\u0e30\u0e14\u0e39\u0e04\u0e48\u0e32\u0e1b\u0e23\u0e30\u0e21\u0e32\u0e13\u0e01\u0e25\u0e38\u0e48\u0e21\u0e40\u0e1b\u0e49\u0e32\u0e2b\u0e21\u0e32\u0e22\u0e08\u0e32\u0e01 Meta \u0e43\u0e2b\u0e49\u0e04\u0e30\u0e41\u0e19\u0e19\u0e04\u0e27\u0e32\u0e21\u0e40\u0e01\u0e35\u0e48\u0e22\u0e27\u0e02\u0e49\u0e2d\u0e07\u0e1e\u0e23\u0e49\u0e2d\u0e21\u0e40\u0e2b\u0e15\u0e38\u0e1c\u0e25 \u0e08\u0e31\u0e14 Interest \u0e17\u0e35\u0e48\u0e43\u0e2b\u0e49\u0e21\u0e32\u0e40\u0e1b\u0e47\u0e19\u0e0a\u0e38\u0e14 A/B/C \u0e1b\u0e23\u0e30\u0e21\u0e32\u0e13\u0e07\u0e1a\u0e41\u0e25\u0e30\u0e40\u0e27\u0e25\u0e32\u0e17\u0e14\u0e2a\u0e2d\u0e1a\u0e08\u0e32\u0e01\u0e2a\u0e21\u0e21\u0e15\u0e34\u0e10\u0e32\u0e19\u0e02\u0e2d\u0e07\u0e04\u0e38\u0e13 \u0e41\u0e25\u0e30\u0e23\u0e48\u0e32\u0e07\u0e04\u0e33\u0e2a\u0e31\u0e48\u0e07\u0e43\u0e2b\u0e49 AI \u0e40\u0e15\u0e23\u0e35\u0e22\u0e21 Saved Audience \u0e40\u0e1e\u0e37\u0e48\u0e2d\u0e43\u0e2b\u0e49\u0e04\u0e38\u0e13\u0e15\u0e23\u0e27\u0e08\u0e2a\u0e2d\u0e1a \u0e20\u0e32\u0e29\u0e32\u0e04\u0e49\u0e19\u0e2b\u0e32\u0e44\u0e21\u0e48\u0e43\u0e0a\u0e48\u0e15\u0e31\u0e27\u0e01\u0e23\u0e2d\u0e07\u0e1b\u0e23\u0e30\u0e40\u0e17\u0e28 \u0e04\u0e48\u0e32\u0e1b\u0e23\u0e30\u0e21\u0e32\u0e13\u0e2d\u0e32\u0e08\u0e40\u0e1b\u0e25\u0e35\u0e48\u0e22\u0e19\u0e41\u0e1b\u0e25\u0e07\u0e41\u0e25\u0e30\u0e43\u0e0a\u0e49\u0e1a\u0e27\u0e01\u0e40\u0e1b\u0e47\u0e19 Reach \u0e23\u0e27\u0e21\u0e44\u0e21\u0e48\u0e44\u0e14\u0e49 \u0e04\u0e30\u0e41\u0e19\u0e19\u0e41\u0e25\u0e30\u0e07\u0e1a\u0e40\u0e1b\u0e47\u0e19\u0e40\u0e04\u0e23\u0e37\u0e48\u0e2d\u0e07\u0e21\u0e37\u0e2d\u0e0a\u0e48\u0e27\u0e22\u0e27\u0e32\u0e07\u0e41\u0e1c\u0e19 \u0e44\u0e21\u0e48\u0e43\u0e0a\u0e48\u0e01\u0e32\u0e23\u0e1e\u0e22\u0e32\u0e01\u0e23\u0e13\u0e4c\u0e1c\u0e25\u0e42\u0e06\u0e29\u0e13\u0e32 MCP \u0e19\u0e35\u0e49\u0e44\u0e21\u0e48\u0e40\u0e0a\u0e37\u0e48\u0e2d\u0e21\u0e15\u0e48\u0e2d Ads Manager \u0e41\u0e25\u0e30\u0e44\u0e21\u0e48\u0e2a\u0e23\u0e49\u0e32\u0e07 \u0e1a\u0e31\u0e19\u0e17\u0e36\u0e01 \u0e41\u0e01\u0e49\u0e44\u0e02 \u0e2b\u0e23\u0e37\u0e2d\u0e40\u0e1c\u0e22\u0e41\u0e1e\u0e23\u0e48\u0e42\u0e06\u0e29\u0e13\u0e32\u0e41\u0e25\u0e30\u0e01\u0e25\u0e38\u0e48\u0e21\u0e40\u0e1b\u0e49\u0e32\u0e2b\u0e21\u0e32\u0e22"
},
"zh-CN": {
"subtitle": "\u641c\u7d22\u5e76\u89c4\u5212 Meta \u5174\u8da3",
"description": "\u641c\u7d22 Meta \u5e7f\u544a\u5b9a\u4f4d\u5174\u8da3\uff0c\u67e5\u770b\u76f4\u63a5\u5339\u914d\u9879\u3001\u76f8\u5173\u5efa\u8bae\u548c Meta \u8fd4\u56de\u7684\u53d7\u4f17\u89c4\u6a21\u4f30\u7b97\uff1b\u4f7f\u7528\u53ef\u89e3\u91ca\u7684\u542f\u53d1\u5f0f\u65b9\u6cd5\u8bc4\u4f30\u76f8\u5173\u6027\uff0c\u5c06\u5df2\u63d0\u4f9b\u7684\u5174\u8da3\u6574\u7406\u4e3a A/B/C \u6d4b\u8bd5\u7ec4\uff0c\u5e76\u6839\u636e\u60a8\u63d0\u4f9b\u7684\u5047\u8bbe\u4f30\u7b97\u9884\u7b97\u4e0e\u6d4b\u8bd5\u65f6\u95f4\u3002\u8fd8\u53ef\u751f\u6210\u4f9b AI \u51c6\u5907 Saved Audience \u7684\u6307\u4ee4\uff0c\u4f9b\u60a8\u5ba1\u6838\u3002\u641c\u7d22\u8bed\u8a00\u4e0d\u4f1a\u7b5b\u9009\u56fd\u5bb6\u3002\u53d7\u4f17\u89c4\u6a21\u53ef\u80fd\u53d8\u5316\u3001\u4e0d\u80fd\u76f8\u52a0\uff0c\u4e5f\u4e0d\u4ee3\u8868\u8d2d\u4e70\u610f\u5411\u6216\u5e7f\u544a\u6548\u679c\u3002MCP \u4e0d\u8fde\u63a5 Ads Manager\uff0c\u4e5f\u4e0d\u4f1a\u521b\u5efa\u3001\u4fdd\u5b58\u3001\u7f16\u8f91\u6216\u53d1\u5e03\u5e7f\u544a\u53ca\u53d7\u4f17\u3002"
},
"ja-JP": {
"subtitle": "Meta\u5e83\u544a\u306e\u8208\u5473\u3092\u691c\u7d22\u30fb\u8a08\u753b",
"description": "Meta\u5e83\u544a\u306e\u30bf\u30fc\u30b2\u30c6\u30a3\u30f3\u30b0\u306b\u4f7f\u3048\u308b\u8208\u5473\u95a2\u5fc3\u3092\u691c\u7d22\u3057\u3001\u76f4\u63a5\u4e00\u81f4\u3068\u95a2\u9023\u5019\u88dc\u3001Meta\u304c\u8fd4\u3059\u63a8\u5b9a\u30aa\u30fc\u30c7\u30a3\u30a8\u30f3\u30b9\u898f\u6a21\u3092\u78ba\u8a8d\u3067\u304d\u307e\u3059\u3002\u7406\u7531\u4ed8\u304d\u306e\u30d2\u30e5\u30fc\u30ea\u30b9\u30c6\u30a3\u30c3\u30af\u8a55\u4fa1\u3001A/B/C\u30c6\u30b9\u30c8\u7528\u30b0\u30eb\u30fc\u30d7\u5206\u3051\u3001\u5165\u529b\u3057\u305f\u524d\u63d0\u306b\u57fa\u3065\u304f\u4e88\u7b97\u3068\u671f\u9593\u306e\u8a66\u7b97\u3001Saved Audience\u6e96\u5099\u7528\u306eAI\u6307\u793a\u6587\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002\u691c\u7d22\u8a00\u8a9e\u306f\u56fd\u3092\u6307\u5b9a\u3057\u307e\u305b\u3093\u3002\u63a8\u5b9a\u5024\u306f\u5909\u52d5\u3057\u3001\u5408\u7b97\u3084\u5e83\u544a\u6210\u679c\u306e\u4e88\u6e2c\u306b\u306f\u4f7f\u3048\u307e\u305b\u3093\u3002MCP\u306fAds Manager\u306b\u63a5\u7d9a\u305b\u305a\u3001\u5e83\u544a\u3084\u30aa\u30fc\u30c7\u30a3\u30a8\u30f3\u30b9\u3092\u4f5c\u6210\u30fb\u7de8\u96c6\u30fb\u516c\u958b\u3057\u307e\u305b\u3093\u3002"
},
"ko-KR": {
"subtitle": "Meta \uad00\uc2ec\uc0ac \uac80\uc0c9 \ubc0f \uacc4\ud68d",
"description": "Meta \uad11\uace0 \ud0c0\uac9f\ud305 \uad00\uc2ec\uc0ac\ub97c \uac80\uc0c9\ud558\uace0 \uc9c1\uc811 \uc77c\uce58 \ud56d\ubaa9, \uad00\ub828 \ucd94\ucc9c, Meta\uac00 \ubc18\ud658\ud55c \uc608\uc0c1 \uc624\ub514\uc5b8\uc2a4 \uaddc\ubaa8\ub97c \ud655\uc778\ud569\ub2c8\ub2e4. \uc124\uba85 \uac00\ub2a5\ud55c \ud734\ub9ac\uc2a4\ud2f1\uc73c\ub85c \uad00\ub828\uc131\uc744 \ud3c9\uac00\ud558\uace0, \uc81c\uacf5\ub41c \uad00\uc2ec\uc0ac\ub97c A/B/C \ud14c\uc2a4\ud2b8 \uc138\ud2b8\ub85c \ub098\ub204\uba70, \uc0ac\uc6a9\uc790\uac00 \uc785\ub825\ud55c \uac00\uc815\uc73c\ub85c \uc608\uc0b0\uacfc \ud14c\uc2a4\ud2b8 \uae30\uac04\uc744 \ucd94\uc815\ud569\ub2c8\ub2e4. Saved Audience \uc900\ube44\ub97c \uc704\ud55c AI \ud504\ub86c\ud504\ud2b8\ub3c4 \uc791\uc131\ud569\ub2c8\ub2e4. \uac80\uc0c9 \uc5b8\uc5b4\ub294 \uad6d\uac00 \ud544\ud130\uac00 \uc544\ub2d9\ub2c8\ub2e4. \uc608\uc0c1 \uaddc\ubaa8\ub294 \ubcc0\ub3d9\ub420 \uc218 \uc788\uace0 \ud569\uc0b0\ud558\uac70\ub098 \uad11\uace0 \uc131\uacfc\ub97c \uc608\uce21\ud558\ub294 \ub370 \uc0ac\uc6a9\ud560 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4. MCP\ub294 Ads Manager\uc5d0 \uc5f0\uacb0\ud558\uac70\ub098 \uad11\uace0 \ubc0f \uc624\ub514\uc5b8\uc2a4\ub97c \uc0dd\uc131\u00b7\uc218\uc815\u00b7\uac8c\uc2dc\ud558\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4."
},
"hi-IN": {
"subtitle": "Meta \u0930\u0941\u091a\u093f\u092f\u093e\u0902 \u0916\u094b\u091c\u0947\u0902",
"description": "Meta \u0935\u093f\u091c\u094d\u091e\u093e\u092a\u0928 \u0932\u0915\u094d\u0937\u094d\u092f\u0940\u0915\u0930\u0923 \u0915\u0940 \u0930\u0941\u091a\u093f\u092f\u093e\u0902 \u0916\u094b\u091c\u0947\u0902, \u0938\u0940\u0927\u0947 \u092e\u093f\u0932\u093e\u0928 \u0914\u0930 \u0938\u0902\u092c\u0902\u0927\u093f\u0924 \u0938\u0941\u091d\u093e\u0935 \u0905\u0932\u0917 \u0926\u0947\u0916\u0947\u0902, \u0924\u0925\u093e Meta \u0926\u094d\u0935\u093e\u0930\u093e \u0932\u094c\u091f\u093e\u090f \u0917\u090f \u0905\u0928\u0941\u092e\u093e\u0928\u093f\u0924 \u0911\u0921\u093f\u092f\u0902\u0938 \u0906\u0915\u093e\u0930 \u0915\u0940 \u0938\u092e\u0940\u0915\u094d\u0937\u093e \u0915\u0930\u0947\u0902\u0964 \u0938\u092e\u091d\u093e\u090f \u091c\u093e \u0938\u0915\u0928\u0947 \u0935\u093e\u0932\u0947 \u0905\u0928\u0941\u092e\u093e\u0928 \u0938\u0947 \u092a\u094d\u0930\u093e\u0938\u0902\u0917\u093f\u0915\u0924\u093e \u0905\u0902\u0915\u093f\u0924 \u0915\u0930\u0947\u0902, \u0926\u0940 \u0917\u0908 \u0930\u0941\u091a\u093f\u092f\u094b\u0902 \u0915\u094b A/B/C \u092a\u0930\u0940\u0915\u094d\u0937\u0923 \u0938\u092e\u0942\u0939\u094b\u0902 \u092e\u0947\u0902 \u0930\u0916\u0947\u0902, \u0914\u0930 \u0906\u092a\u0915\u0947 \u0905\u0928\u0941\u092e\u093e\u0928\u094b\u0902 \u0915\u0947 \u0906\u0927\u093e\u0930 \u092a\u0930 \u092c\u091c\u091f \u0935 \u0905\u0935\u0927\u093f \u0915\u093e \u0939\u093f\u0938\u093e\u092c \u0932\u0917\u093e\u090f\u0902\u0964 Saved Audience \u0924\u0948\u092f\u093e\u0930 \u0915\u0930\u0928\u0947 \u0915\u0947 \u0932\u093f\u090f AI \u0928\u093f\u0930\u094d\u0926\u0947\u0936 \u092d\u0940 \u092c\u0928\u093e\u090f\u0902\u0964 \u0916\u094b\u091c \u0915\u0940 \u092d\u093e\u0937\u093e \u0926\u0947\u0936 \u092b\u093c\u093f\u0932\u094d\u091f\u0930 \u0928\u0939\u0940\u0902 \u0939\u0948\u0964 \u0911\u0921\u093f\u092f\u0902\u0938 \u0905\u0928\u0941\u092e\u093e\u0928 \u092c\u0926\u0932 \u0938\u0915\u0924\u0947 \u0939\u0948\u0902, \u091c\u094b\u0921\u093c\u0915\u0930 \u0915\u0941\u0932 \u092a\u0939\u0941\u0902\u091a \u0928\u0939\u0940\u0902 \u092c\u0924\u093e\u0908 \u091c\u093e \u0938\u0915\u0924\u0940, \u0914\u0930 \u0935\u0947 \u0935\u093f\u091c\u094d\u091e\u093e\u092a\u0928 \u092a\u0930\u093f\u0923\u093e\u092e \u0915\u0940 \u092d\u0935\u093f\u0937\u094d\u092f\u0935\u093e\u0923\u0940 \u0928\u0939\u0940\u0902 \u0939\u0948\u0902\u0964 MCP Ads Manager \u0938\u0947 \u0928\u0939\u0940\u0902 \u091c\u0941\u0921\u093c\u0924\u093e \u0914\u0930 \u0935\u093f\u091c\u094d\u091e\u093e\u092a\u0928 \u092f\u093e \u0911\u0921\u093f\u092f\u0902\u0938 \u0928\u0939\u0940\u0902 \u092c\u0928\u093e\u0924\u093e, \u0938\u0902\u092a\u093e\u0926\u093f\u0924 \u092f\u093e \u092a\u094d\u0930\u0915\u093e\u0936\u093f\u0924 \u0928\u0939\u0940\u0902 \u0915\u0930\u0924\u093e\u0964"
},
"id-ID": {
"subtitle": "Cari dan rencanakan minat Meta",
"description": "Cari minat penargetan iklan Meta, lihat kecocokan langsung dan saran terkait secara terpisah, serta tinjau perkiraan ukuran audiens dari Meta. Nilai relevansi dengan metode heuristik yang disertai alasan, kelompokkan minat yang diberikan ke set uji A/B/C, dan hitung perkiraan anggaran serta durasi berdasarkan asumsi Anda. Buat juga prompt AI untuk menyiapkan Saved Audience agar dapat Anda tinjau. Bahasa pencarian bukan filter negara. Perkiraan dapat berubah, tidak boleh dijumlahkan, dan bukan prediksi performa iklan. MCP tidak terhubung ke Ads Manager dan tidak membuat, mengedit, atau menerbitkan iklan maupun audiens."
}
}
},
"apps": "./.app.json"
}
}
}
SHA-256: 59215e85d1dbc1cb7cee852b3b5bd29c8c0e10877b2e4e6a97da204d42d55b3f