Capzy Platforms / facebook
facebook toolset
17 tools. Mount this server and your agent gets every facebook endpoint, fully typed.
claude mcp add capzy-facebook --transport http https://mcp.capzy.ai/facebook/mcp \ --header "Authorization: Bearer YOUR_KEY"
Ads
facebook_ad
1 credit
not yet verified
Get Ad
Get ad details from the archive.
| Param | Type | Required | Description |
|---|---|---|---|
ad_archive_id |
string | required | Ad archive id. |
facebook_ads_search
1 credit
not yet verified
Ads Search
Search the public Ad Library archive.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Advertiser name or keyword (aka search_terms). |
search_terms |
string | optional | Alias of query. |
country |
string | optional | Country code the ads ran in. Default: US |
ad_type |
string | optional | Ad category to search. Default: all |
platform |
string | optional | Publisher surface the ad ran on. Default: all |
active_status |
string | optional | Ad delivery status. Default: all |
media_type |
string | optional | Creative media type. Default: all |
start_date |
string | optional | Only ads that started running on/after this date (YYYY-MM-DD). |
end_date |
string | optional | Only ads that started running on/before this date (YYYY-MM-DD). |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
Groups
facebook_group
1 credit
not yet verified
Get Group
Group metadata and details.
| Param | Type | Required | Description |
|---|---|---|---|
group_id |
string | required | Group id or slug. |
facebook_group_posts
1 credit
not yet verified
Group Posts
Retrieve a group feed.
| Param | Type | Required | Description |
|---|---|---|---|
group_id |
string | required | Group id or slug. |
limit |
integer | optional | Maximum posts to return (aka amount). Default: 20 |
amount |
integer | optional | Alias of limit. Default: 20 |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
after |
string | optional | Alias of cursor (mbasic 'See more' token). |
Marketplace
facebook_marketplace_category
1 credit
not yet verified
Marketplace Category
Browse an entire marketplace category.
| Param | Type | Required | Description |
|---|---|---|---|
category |
string | required | Category slug. |
location |
string | optional | Location id/slug. |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
facebook_marketplace_item
1 credit
not yet verified
Marketplace Item
Complete listing details.
| Param | Type | Required | Description |
|---|---|---|---|
item_id |
string | required | Marketplace item id. |
facebook_marketplace_search
1 credit
not yet verified
Marketplace Search
Find marketplace listings by keyword.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search keyword. |
location |
string | optional | Location id/slug. |
category |
string | optional | Restrict to a marketplace category slug. |
price_min |
integer | optional | Minimum listing price. |
price_max |
integer | optional | Maximum listing price. |
condition |
string | optional | Item condition filter. |
sort |
string | optional | Result ordering. Default: best_match |
radius |
integer | optional | Search radius (km) around the location. |
days_since_listed |
integer | optional | Only listings posted within the last N days (1, 7, or 30). |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
Pages
facebook_page
1 credit
Get Page
Get page or profile details.
| Param | Type | Required | Description |
|---|---|---|---|
identifier |
string | required | Page id or username. |
facebook_page_posts
1 credit
not yet verified
Page Posts
Retrieve a page timeline.
| Param | Type | Required | Description |
|---|---|---|---|
identifier |
string | required | Page id or username. |
limit |
integer | optional | Maximum posts to return (aka amount). Default: 20 |
amount |
integer | optional | Alias of limit. Default: 20 |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
after |
string | optional | Alias of cursor (mbasic 'See more' token). |
Posts
facebook_post
1 credit
not yet verified
Get Post
Single post with author, media and reactions.
| Param | Type | Required | Description |
|---|---|---|---|
post_id |
string | required | Post id (story fbid). |
facebook_post_comments
1 credit
not yet verified
Post Comments
Retrieve a post comment thread.
| Param | Type | Required | Description |
|---|---|---|---|
post_id |
string | required | Post id (story fbid). |
sort |
string | optional | Comment ordering. Default: most_relevant |
limit |
integer | optional | Maximum comments to return (aka amount). Default: 50 |
amount |
integer | optional | Alias of limit. Default: 50 |
cursor |
string | optional | Pagination cursor from a previous response. |
after |
string | optional | Alias of cursor (mbasic next-page token). |
Profiles
facebook_profile
1 credit
Get Profile
Get user profile information.
| Param | Type | Required | Description |
|---|---|---|---|
identifier |
string | required | Profile id or username. |
facebook_profile_posts
1 credit
not yet verified
Profile Posts
Retrieve a profile timeline.
| Param | Type | Required | Description |
|---|---|---|---|
identifier |
string | required | Profile id or username. |
limit |
integer | optional | Maximum posts to return (aka amount). Default: 20 |
amount |
integer | optional | Alias of limit. Default: 20 |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
after |
string | optional | Alias of cursor (mbasic 'See more' token). |
Reference
facebook_marketplace_categories
1 credit
Marketplace Categories
Marketplace categories.
No parameters.
facebook_marketplace_locations
1 credit
Marketplace Locations
Available marketplace locations.
No parameters.
Search
facebook_search
1 credit
Global Search
Search across all tabs globally.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query. |
tab |
string | optional | Restrict to one result tab. Default: top |
page |
integer | optional | Result page (1-based). Default: 1 |
cursor |
string | optional | Pagination cursor from a previous response. |
facebook_search_tab
1 credit
not yet verified
Search Tab
Search a specific tab (pages/people/groups/posts/places/events).
| Param | Type | Required | Description |
|---|---|---|---|
tab |
string | required | One of: top, posts, people, pages, groups, marketplace, videos, events |
query |
string | required | Search query. |
page |
integer | optional | Result page (1-based). Default: 1 |
after |
string | optional | Pagination cursor. |
Fewer tools?
The aggregate server at https://mcp.capzy.ai/mcp reaches this platform through 5 discovery meta-tools, and https://mcp.capzy.ai/search/mcp carries just each platform's primary search.