Manifold MCP

Get an app store chart

apps_get_top_charts

Read-onlyIdempotent

A store's top chart (free, paid, grossing or new) overall or in one category, in chart order.

Use when: "top free business apps", "what is grossing in the App Store's finance chart", spotting rising apps in a category. Not for: apps matching a word, use apps_search_apps. One app's details, use apps_get_app. Returns: List. rows[]: rank, app_id, title, url, developer (Google Play only), rating, ratings_count (App Store only), is_free, price, currency. Cost: 1 credit per 100 rows. Default 100 rows = 1 credit. Cached 1 day. Can take up to a minute. Example: {"store": "app_store", "chart": "top_free", "category": "health_and_fitness"}

Input Schema

TableJSON Schema

Name	Required	Description	Default
`chart`	No		top_free
`limit`	No	Max rows. Default 100; Google Play goes to 200, the App Store to 100.
`store`	Yes	google_play or app_store.
`dry_run`	No	Return only meta with the estimate. Costs nothing.
`category`	No	The store's category id in lower case with underscores; a name such as "Health & Fitness" is turned into one, and a wrong id is refused free. Omit for every category. App Store: books, business, education, entertainment, finance, food_and_drink, games, health_and_fitness, lifestyle, magazines_and_newspapers, medical, music, navigation, news, photo_and_video, productivity, reference, shopping, social_networking, sports, travel, utilities, weather, and games_puzzle and other games_ genres. Google Play: art_and_design, auto_and_vehicles, beauty, books_and_reference, business, comics, communication, dating, education, entertainment, events, family, finance, food_and_drink, health_and_fitness, house_and_home, libraries_and_demo, lifestyle, maps_and_navigation, medical, music_and_audio, news_and_magazines, parenting, personalization, photography, productivity, shopping, social, sports, tools, travel_and_local, video_players, weather, game, and game_puzzle and other game_ genres.
`language`	No	ISO 639-1 language code. Default en.	en
`location`	No	Provider location name or code. Default United States.	United States
`max_credits`	No	Refuse with BudgetExceeded if the estimate is higher.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`meta`	Yes
`rows`	No
`error`	No
`hints`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 17, 2026

changedInput schema / properties / category / description

Previous value: -"The store's category id, such as health_and_fitness or food_and_drink. Omit for every category."New value: +"The store's category id in lower case with underscores; a name such as \"Health & Fitness\" is turned into one, and a wrong id is refused free. Omit for every category. App Store: books, business, education, entertainment, finance, food_and_drink, games, health_and_fitness, lifestyle, magazines_and_newspapers, medical, music, navigation, news, photo_and_video, productivity, reference, shopping, social_networking, sports, travel, utilities, weather, and games_puzzle and other games_ genres. Google Play: art_and_design, auto_and_vehicles, beauty, books_and_reference, business, comics, communication, dating, education, entertainment, events, family, finance, food_and_drink, health_and_fitness, house_and_home, libraries_and_demo, lifestyle, maps_and_navigation, medical, music_and_audio, news_and_magazines, parenting, personalization, photography, productivity, shopping, social, sports, tools, travel_and_local, video_players, weather, game, and game_puzzle and other game_ genres."

Changed15 schema fields changedOct 17, 2026

removedInput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

removedInput schema / properties / max_credits / maximum
```
Removed value: -9007199254740991
```

removedInput schema / properties / provider

Removed value: -{
-  "description": "Provider id. Defaults to the server default for the tool.",
-  "type": "string"
-}

removedOutput schema / $schema

Removed value: -"https://json-schema.org/draft/2020-12/schema"

addedOutput schema / properties / error / additionalProperties
```
Added value: +{}
```

removedOutput schema / properties / error / oneOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "BudgetExceeded",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "max_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "max_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "billing_url": {
-        "type": "string"
-      },
-      "error": {
-        "const": "InsufficientCredits",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "upgrade_url": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "est_credits",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "NoData",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidTarget",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "target": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "target",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "InvalidProvider",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "valid_providers": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "valid_providers",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ProviderUnavailable",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "provider": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "provider",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "ConcurrencyLimit",
-        "type": "string"
-      },
-      "limit": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "retry_after_s": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "limit",
-      "retry_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "cap": {
-        "type": "number"
-      },
-      "error": {
-        "const": "SpendCapReached",
-        "type": "string"
-      },
-      "est_credits": {
-        "type": "number"
-      },
-      "message": {
-        "type": "string"
-      },
-      "period": {
-        "enum": [
-          "day",
-          "month"
-        ],
-        "type": "string"
-      },
-      "resets_at": {
-        "type": "string"
-      },
-      "spent": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "error",
-      "period",
-      "cap",
-      "spent",
-      "est_credits",
-      "resets_at",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskFailed",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "const": "TaskPending",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      },
-      "poll_after_s": {
-        "type": "number"
-      },
-      "task_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "task_id",
-      "poll_after_s",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "connect_url": {
-        "type": "string"
-      },
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "NotConnected",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "connect_url",
-      "message"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "engine": {
-        "type": "string"
-      },
-      "error": {
-        "const": "EngineMisconfigured",
-        "type": "string"
-      },
-      "message": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "error",
-      "engine",
-      "message"
-    ],
-    "type": "object"
-  }
-]

addedOutput schema / properties / error / properties

Added value: +{
+  "error": {
+    "enum": [
+      "BudgetExceeded",
+      "InsufficientCredits",
+      "NoData",
+      "InvalidTarget",
+      "InvalidProvider",
+      "ProviderUnavailable",
+      "ConcurrencyLimit",
+      "SpendCapReached",
+      "TaskFailed",
+      "TaskPending",
+      "NotConnected",
+      "EngineMisconfigured"
+    ],
+    "type": "string"
+  },
+  "message": {
+    "type": "string"
+  }
+}

addedOutput schema / properties / error / required
```
Added value: +[
+  "error",
+  "message"
+]
```
addedOutput schema / properties / error / type
```
Added value: +"object"
```

removedOutput schema / properties / errors

Removed value: -{
-  "description": "Per-input failures of a batch call.",
-  "items": {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "BudgetExceeded",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "max_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "est_credits",
-              "max_credits",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "billing_url": {
-                "type": "string"
-              },
-              "error": {
-                "const": "InsufficientCredits",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "upgrade_url": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "est_credits",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "NoData",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "InvalidTarget",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "target": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "target",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "InvalidProvider",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "provider": {
-                "type": "string"
-              },
-              "valid_providers": {
-                "items": {
-                  "type": "string"
-                },
-                "type": "array"
-              }
-            },
-            "required": [
-              "error",
-              "provider",
-              "valid_providers",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "ProviderUnavailable",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "provider": {
-                "type": "string"
-              },
-              "retry_after_s": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "provider",
-              "retry_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "ConcurrencyLimit",
-                "type": "string"
-              },
-              "limit": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "retry_after_s": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "limit",
-              "retry_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "cap": {
-                "type": "number"
-              },
-              "error": {
-                "const": "SpendCapReached",
-                "type": "string"
-              },
-              "est_credits": {
-                "type": "number"
-              },
-              "message": {
-                "type": "string"
-              },
-              "period": {
-                "enum": [
-                  "day",
-                  "month"
-                ],
-                "type": "string"
-              },
-              "resets_at": {
-                "type": "string"
-              },
-              "spent": {
-                "type": "number"
-              }
-            },
-            "required": [
-              "error",
-              "period",
-              "cap",
-              "spent",
-              "est_credits",
-              "resets_at",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "TaskFailed",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "task_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "task_id",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "error": {
-                "const": "TaskPending",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "poll_after_s": {
-                "type": "number"
-              },
-              "task_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "task_id",
-              "poll_after_s",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "connect_url": {
-                "type": "string"
-              },
-              "engine": {
-                "type": "string"
-              },
-              "error": {
-                "const": "NotConnected",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "engine",
-              "connect_url",
-              "message"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "engine": {
-                "type": "string"
-              },
-              "error": {
-                "const": "EngineMisconfigured",
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "error",
-              "engine",
-              "message"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "input": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "input",
-      "error"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

changedOutput schema / properties / meta / properties / rows_available / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / meta / properties / rows_returned / maximum
```
Removed value: -9007199254740991
```
removedOutput schema / properties / meta / properties / rows_returned / minimum
```
Removed value: --9007199254740991
```

changedOutput schema / properties / rows / items / properties / rank / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / rows / items / properties / ratings_count / anyOf

Previous value: -[
-  {
-    "maximum": 9007199254740991,
-    "minimum": -9007199254740991,
-    "type": "integer"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "type": "integer"
+  },
+  {
+    "type": "null"
+  }
+]

Changed3 schema fields changedOct 17, 2026

addedOutput schema / properties / meta / properties / credits_notice

Added value: +{
+  "additionalProperties": false,
+  "description": "A free workspace is low on credits, at most once a day. Tell the user once.",
+  "properties": {
+    "message": {
+      "type": "string"
+    },
+    "resets_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "upgrade_url": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "upgrade_url",
+    "resets_at",
+    "message"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / meta / properties / credits_remaining

Added value: +{
+  "description": "The workspace's credits left after this call. null when the call did not check the balance (free tools, cache hits, dry runs, tasks) or the balance has no limit.",
+  "type": [
+    "number",
+    "null"
+  ]
+}

changedOutput schema / properties / meta / required

Previous value: -[
-  "provider",
-  "credits_charged",
-  "est_credits",
-  "cached",
-  "data_as_of",
-  "rows_returned",
-  "rows_available",
-  "cursor",
-  "request_id"
-]New value: +[
+  "provider",
+  "credits_charged",
+  "est_credits",
+  "cached",
+  "data_as_of",
+  "rows_returned",
+  "rows_available",
+  "cursor",
+  "request_id",
+  "credits_remaining"
+]

Changed3 schema fields changedOct 16, 2026

changedInput schema / properties / category / description

Previous value: -"The store's category id, such as business or finance. Omit for every category."New value: +"The store's category id, such as health_and_fitness or food_and_drink. Omit for every category."

addedOutput schema / properties / rows / items / properties / developer / description
```
Added value: +"Google Play only."
```
addedOutput schema / properties / rows / items / properties / ratings_count / description
```
Added value: +"App Store only."
```

AddedOct 15, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, openWorld, and non-destructive behavior. The description adds meaningful operational context: cost (1 credit per 100 rows, default 100 rows = 1 credit), 1-day caching, and potential latency up to a minute.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded and organized into clear sections: purpose, use cases, exclusions, return shape, cost, and example. Every sentence serves a distinct purpose with no wasted text.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, the description still helpfully summarizes returned fields and includes cost, latency, caching, usage guidance, and an example. Nothing essential for correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is high (88%), so the schema already documents most parameters, including chart enums, category IDs, limit bounds, and dry_run. The description adds only a small amount beyond the schema, such as the cost implication of the default 100-row limit and a full example request.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific resource and scope: a store's top chart, with chart types and overall/category options, in chart order. It clearly distinguishes itself from siblings by naming apps_search_apps and apps_get_app as alternatives for different needs.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit 'Use when' examples and a 'Not for' section name the correct alternatives for app search and single-app details. An agent can decide when to call this tool versus apps_search_apps or apps_get_app without opening either schema.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Manifold MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?