apinoa-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| APINOA_API_KEY | Yes | Required for every data call. Create a key under Dashboard > API keys at apinoa.com. | |
| APINOA_BASE_URL | No | Base URL for the apinoa API gateway. | https://gateway.apinoa.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_productsA | Search a marketplace's products by keyword. Returns a SearchResult: items with title, price, rating, seller and url. Platforms and the params each accepts (* = required; query may be given at the top level):
For the next page pass params.page = 2, 3, … (or params.cursor where the platform returns one). Costs are in units of $0.001 at list price; a call that fails is not billed. |
| get_productA | One product in full: variants, images, specifications, seller, delivery and price. Platforms and the params each accepts (* = required; id may be given at the top level):
Costs are in units of $0.001 at list price; a call that fails is not billed. |
| get_product_reviewsA | A product's reviews, one page at a time. Platforms and the params each accepts (* = required; id may be given at the top level):
For the next page pass params.page or params.cursor as the previous answer indicates. Costs are in units of $0.001 at list price; a call that fails is not billed. |
| list_categoriesA | One level of a marketplace's category tree. Omit params.categoryId for the top level; pass an id for its children. Ids feed browse_category. Platforms and the params each accepts (* = required):
Costs are in units of $0.001 at list price; a call that fails is not billed. |
| browse_categoryA | The products in one category, with no keyword. Get category ids from list_categories. Platforms and the params each accepts (* = required):
For the next page pass params.page = 2, 3, … Costs are in units of $0.001 at list price; a call that fails is not billed. |
| get_social_profileA | One account on a social platform: name, bio, follower counts, verification, links. Platforms and the params each accepts (* = required; username may be given at the top level):
Costs are in units of $0.001 at list price; a call that fails is not billed. |
| list_social_postsA | Posts from a social platform. What you pass in params picks the source: an account's (username), a search (query), a hashtag, community, sound, company, playlist, posts related to one (relatedTo) — or nothing for the trending feed. Platforms and the params each accepts (* = required):
For the next page call again with params = { cursor } alone, using the cursor of the previous answer. Costs are in units of $0.001 at list price; a call that fails is not billed. |
| get_social_postA | One post: text, author, media, counts, time. Platforms and the params each accepts (* = required; id may be given at the top level):
Costs are in units of $0.001 at list price; a call that fails is not billed. |
| get_social_commentsA | A post's comments (params.post), one comment's replies (params.comment), or an account's comments. Platforms and the params each accepts (* = required):
For the next page call again with params = { cursor } alone. Costs are in units of $0.001 at list price; a call that fails is not billed. |
| search_products_by_imageA | Find a marketplace's products that match a photo. Give the photo as a URL; it is downloaded and sent as the search image. Platforms: aliexpress, amazon, shopify |
| call_apinoaA | Call any operation of the apinoa API directly, for what the other tools do not cover (store catalogs, shipping quotes, groups, followers, LinkedIn jobs…). Every platform and its operations (params of each are listed by list_platforms):
|
| list_platformsA | Every platform apinoa serves, its operations, what each costs, and the parameters each operation accepts. Free, and needs no key. |
| translate_imageA | Replace the text inside a product image with a translation, keeping fonts, colours and layout. Give the image as a URL. Returns the translated image. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool pairs a distinct resource with a distinct action: keyword search, image search, category browse, product fetch, reviews, and separate social profile/post/comment fetches. The only overlap is call_apinoa, which is a deliberate catch-all and is explicitly scoped to operations the named tools don't cover, though an agent may still hesitate between it and the dedicated tools.
Nearly all tools follow a clean snake_case verb_noun convention (search_products, get_product, list_categories, browse_category, list_social_posts, get_social_comments). The one longer name, search_products_by_image, still reads consistently and clearly mirrors its keyword counterpart.
At 12-13 tools for a multi-platform commerce + social API, each tool earns its place: one per core operation, plus a single escape hatch for the long tail. This is exactly the scope where a per-operation surface stays manageable rather than exploding into dozens of tools.
Core lifecycle coverage is strong: search (keyword and image), browse by category, full product detail, reviews, and the social profile/post/comment trio. Gaps like shipping quotes, catalogs, groups, followers and LinkedIn jobs exist but are explicitly reachable via call_apinoa, so they are workable rather than dead ends.