Upstar
Rising GitHub repos per topic, ranked by star velocity, plus repos spotted early. Free, read-only.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"upstar": {
"url": "https://upstar.dev/mcp"
}
}
}Remote endpoints
https://upstar.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (9)
🟢emerging(lang, detail, topic, limit, offset)
Small GitHub repositories (under 1,000 stars a week ago, at least 30 days old) gaining stars at least twice as fast as in a usual week, by that ratio; optionally in one topic. The same list as Upstar's Emerging page (or the topic's Emerging tab).
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"topic": {
"type": "string",
"description": "only this topic's emerging repositories (a slug from list_topics); all topics when empty",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9][a-z0-9-]{0,49}$"
},
"limit": {
"type": "integer",
"description": "how many repositories, 1 to 50 (10 by default)",
"default": 10,
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"description": "how many places of the ranking to pass over, for the next page (next_offset of the previous answer); 0 by default, at most the number of repositories ranked",
"default": 0,
"minimum": 0,
"maximum": 10000
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"topic": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "the topic's id, for topic_ranking and emerging"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"category_name": {
"type": "string"
},
"description": {
"type": "string"
},
"ranked_this_week": {
"type": "integer",
"description": "repositories ranked in it this week"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"category",
"category_name",
"description",
"ranked_this_week",
"url"
],
"additionalProperties": false
}
]
},
"ranked": {
"type": "integer",
"description": "how many repositories are emerging (in the topic, when one is given)"
},
"repos": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
},
"usual_week": {
"type": "integer",
"description": "stars in a usual week: the median of the 8 weeks before"
},
"pace": {
"type": "number",
"description": "this week's stars ÷ the usual week (a usual week under 10 counts as 10)"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url",
"usual_week",
"pace"
],
"additionalProperties": false
}
}
]
},
"next_offset": {
"type": "integer",
"description": "the offset of the next page; absent on the last one"
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"ranked",
"repos"
],
"additionalProperties": false
}🟢get_collection(lang, detail, collection, limit, offset)
A collection's ranking (score = momentum and health with the collection's weights) and its rising newcomers under 90 days old: the same lists as the collection's page on Upstar.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"collection": {
"type": "string",
"description": "the collection's slug, from list_collections",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9][a-z0-9-]{0,49}$"
},
"limit": {
"type": "integer",
"description": "how many ranked repositories, 1 to 50 (10 by default); newcomers come apart, 10 at most",
"default": 10,
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"description": "how many places of the ranking to pass over, for the next page (next_offset of the previous answer); 0 by default, at most the number of repositories ranked",
"default": 0,
"minimum": 0,
"maximum": 10000
}
},
"required": [
"collection"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"collection": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "tooling or alternatives"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"replaces": {
"description": "the products an alternatives collection replaces",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"ranked": {
"type": "integer",
"description": "repositories in its ranking"
},
"newcomers": {
"type": "integer",
"description": "rising repositories under 90 days old, listed apart"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"kind",
"name",
"description",
"ranked",
"newcomers",
"url"
],
"additionalProperties": false
},
"repos": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
},
"score": {
"type": "number",
"description": "momentum and health with the collection's weights, 0 to 100"
},
"license": {
"type": "string"
},
"last_release_on": {
"type": "string"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url",
"score"
],
"additionalProperties": false
}
}
]
},
"newcomers": {
"description": "rising repositories under 90 days old, on the first page only",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url"
],
"additionalProperties": false
}
}
]
},
"next_offset": {
"type": "integer",
"description": "the offset of the next page; absent on the last one"
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"collection",
"repos",
"newcomers"
],
"additionalProperties": false
}🟢get_repo(lang, detail, repo)
One GitHub repository as Upstar sees it, the same facts as its Upstar page: stars and gains, its usual week, its star total week by week over 12 weeks, its topics and ranks, when Upstar spotted it, its latest release, license, activity and collections. Answers for every repository with an Upstar page, kept-out ones included; blocked ones have none.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"repo": {
"type": "string",
"description": "the repository: owner/name, or its GitHub or Upstar address",
"minLength": 3,
"maxLength": 200
}
},
"required": [
"repo"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"repo": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
},
"license": {
"type": "string",
"description": "SPDX id GitHub detected"
},
"homepage": {
"type": "string"
},
"forks": {
"type": "integer"
},
"watchers": {
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"issues": {
"description": "issues opened, all time",
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"pull_requests": {
"description": "pull requests opened, all time",
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"commits": {
"description": "commits on the default branch",
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"contributors": {
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"pushed_on": {
"type": "string"
},
"github_topics": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"usual_week": {
"type": "integer",
"description": "stars in a usual week: the median of the 8 weeks before this one"
},
"health_score": {
"description": "0 to 100, when assessed",
"anyOf": [
{
"type": "null"
},
{
"type": "integer"
}
]
},
"ranks": {
"description": "its ranks in its topics: this week's (compact), or over 24 hours, 7 and 30 days (full)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"topic": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
},
"period": {
"type": "string"
},
"rank": {
"type": "integer"
},
"of": {
"type": "integer",
"description": "how many repositories rank in the topic over the period"
}
},
"required": [
"topic",
"period",
"rank",
"of"
],
"additionalProperties": false
}
}
]
},
"star_history": {
"description": "star total week by week over 12 weeks",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"week_of": {
"type": "string",
"description": "the week's first day (YYYY-MM-DD)"
},
"stars": {
"type": "integer"
}
},
"required": [
"week_of",
"stars"
],
"additionalProperties": false
}
}
]
},
"spotted": {
"description": "when Upstar first ranked it, shown once its stars at least doubled",
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"spotted_on": {
"type": "string"
},
"spotted_in": {
"description": "the topic it was first ranked in; absent when the repo has left that topic",
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
]
},
"rank_when_spotted": {
"type": "integer",
"description": "its rank in that topic's weekly ranking then, any rank; absent when not kept (before November 2026) or the repo has left that topic"
},
"stars_when_spotted": {
"type": "integer"
},
"growth": {
"type": "string",
"description": "how many times its stars grew since"
}
},
"required": [
"spotted_on",
"stars_when_spotted",
"growth"
],
"additionalProperties": false
}
]
},
"latest_release": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"tag": {
"type": "string"
},
"published_on": {
"type": "string"
}
},
"required": [
"tag"
],
"additionalProperties": false
}
]
},
"collections": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url",
"forks",
"usual_week"
],
"additionalProperties": false
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"repo"
],
"additionalProperties": false
}🟢list_collections(lang, detail, kind)
Upstar's collections: open-source tools that do one job, or alternatives to one product, each ranked by momentum and health. Use a slug with get_collection.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"kind": {
"type": "string",
"description": "tooling (open-source tools for one job) or alternatives (open-source alternatives to one product); both when empty",
"enum": [
"tooling",
"alternatives"
]
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"count": {
"type": "integer",
"description": "how many collections this answer lists"
},
"collections": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "tooling or alternatives"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"replaces": {
"description": "the products an alternatives collection replaces",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "string"
}
}
]
},
"ranked": {
"type": "integer",
"description": "repositories in its ranking"
},
"newcomers": {
"type": "integer",
"description": "rising repositories under 90 days old, listed apart"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"kind",
"name",
"description",
"ranked",
"newcomers",
"url"
],
"additionalProperties": false
}
}
]
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"count",
"collections"
],
"additionalProperties": false
}🟢list_topics(lang, detail, category)
Lists the topics Upstar ranks GitHub repositories in (emulation, self-hosted, Rust, MCP…): slug, name, category, description and how many repositories rank in each this week. Use a slug with topic_ranking or emerging.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"category": {
"type": "string",
"description": "only this category's topics (a category slug from an earlier answer)",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9][a-z0-9-]{0,49}$"
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"count": {
"type": "integer",
"description": "how many topics this answer lists (all of Upstar's topics, or a category's)"
},
"categories": {
"description": "the categories (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"slug",
"name",
"description"
],
"additionalProperties": false
}
}
]
},
"topics": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "the topic's id, for topic_ranking and emerging"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"category_name": {
"type": "string"
},
"description": {
"type": "string"
},
"ranked_this_week": {
"type": "integer",
"description": "repositories ranked in it this week"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"category",
"category_name",
"description",
"ranked_this_week",
"url"
],
"additionalProperties": false
}
}
]
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"count",
"topics"
],
"additionalProperties": false
}🟢search(lang, detail, query, limit)
Upstar's search, the same as the site's search bar: topics by whole words (a name, slug, GitHub tag, language or keyword equal to the query, then every word of it in the topic's name, category or description) and every repository with an Upstar page (by name, description, GitHub topics and language; kept-out ones included, blocked ones apart); plain matching, no AI. Repositories: exact name first, then the most stars gained this week.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"query": {
"type": "string",
"description": "words to look for: a repository's name or owner/name, a word of its description, a GitHub topic, a language or a topic's name",
"minLength": 2,
"maxLength": 100
},
"limit": {
"type": "integer",
"description": "how many repositories, 1 to 50 (10 by default)",
"default": 10,
"minimum": 1,
"maximum": 50
}
},
"required": [
"query"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"query": {
"type": "string"
},
"topics": {
"description": "topics matching the query by whole words, strongest first: slug, name, GitHub tag, language or keyword equal to it; then name and tags; then category; then description; the same as the site's search bar",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "the topic's id, for topic_ranking and emerging"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"category_name": {
"type": "string"
},
"description": {
"type": "string"
},
"ranked_this_week": {
"type": "integer",
"description": "repositories ranked in it this week"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"category",
"category_name",
"description",
"ranked_this_week",
"url"
],
"additionalProperties": false
}
}
]
},
"repos": {
"description": "the first matching repositories, best match first (exact name, then name, description, GitHub topic, language; then stars gained this week): the same as the site's search bar",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url"
],
"additionalProperties": false
}
}
]
},
"matches": {
"type": "integer",
"description": "how many repositories the search finds in all"
},
"left_out": {
"description": "matching repositories the search does not return: blocked by Upstar, so without a page",
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"blocked": {
"type": "integer",
"description": "blocked by Upstar's moderation"
}
},
"required": [
"count"
],
"additionalProperties": false
}
]
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"query",
"topics",
"repos",
"matches"
],
"additionalProperties": false
}🟢spotted_early(lang, detail, limit)
Repositories whose stars at least doubled since Upstar first ranked them in a topic, at any rank: when, in which topic and at which rank it first ranked them, their stars then and now. Most grown first: the same list as Upstar's Spotted early page.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"limit": {
"type": "integer",
"description": "how many repositories, 1 to 50 (10 by default)",
"default": 10,
"minimum": 1,
"maximum": 50
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"repos": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
},
"spotted_on": {
"type": "string",
"description": "the day Upstar first ranked it (YYYY-MM-DD)"
},
"spotted_in": {
"description": "the topic it was first ranked in; absent when the repo has left that topic",
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
]
},
"rank_when_spotted": {
"type": "integer",
"description": "its rank in that topic's weekly ranking then, any rank; absent when not kept (before November 2026) or the repo has left that topic"
},
"stars_when_spotted": {
"type": "integer"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url",
"spotted_on",
"stars_when_spotted"
],
"additionalProperties": false
}
}
]
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"repos"
],
"additionalProperties": false
}🟢topic_ranking(lang, detail, topic, period, limit, ...)
Ranks a topic's GitHub repositories by star velocity (stars gained ÷ √stars before) over the last 24 hours, 7 days or 30 days, with the stars each gained: the same list as the topic's page on Upstar. Page with offset (next_offset).
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"topic": {
"type": "string",
"description": "the topic's slug, from list_topics or search (rust, self-hosted, emulation…)",
"minLength": 1,
"maxLength": 50,
"pattern": "^[a-z0-9][a-z0-9-]{0,49}$"
},
"period": {
"type": "string",
"description": "day (last 24 hours), week (last 7 days, the default) or month (last 30 days)",
"default": "week",
"enum": [
"day",
"week",
"month"
]
},
"limit": {
"type": "integer",
"description": "how many repositories, 1 to 50 (10 by default)",
"default": 10,
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"description": "how many places of the ranking to pass over, for the next page (next_offset of the previous answer); 0 by default, at most the number of repositories ranked",
"default": 0,
"minimum": 0,
"maximum": 10000
}
},
"required": [
"topic"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"topic": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "the topic's id, for topic_ranking and emerging"
},
"name": {
"type": "string"
},
"category": {
"type": "string"
},
"category_name": {
"type": "string"
},
"description": {
"type": "string"
},
"ranked_this_week": {
"type": "integer",
"description": "repositories ranked in it this week"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"category",
"category_name",
"description",
"ranked_this_week",
"url"
],
"additionalProperties": false
},
"period": {
"type": "string"
},
"ranked": {
"type": "integer",
"description": "how many repositories rank in the topic over the period"
},
"repos": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url"
],
"additionalProperties": false
}
}
]
},
"next_offset": {
"type": "integer",
"description": "the offset of the next page; absent on the last one"
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"topic",
"period",
"ranked",
"repos"
],
"additionalProperties": false
}🟢trending(lang, detail, period, sort, new_only, ...)
The fastest-rising GitHub repositories across every topic Upstar tracks, by star velocity or by stars gained, over 24 hours, 7 days or 30 days; new_only keeps repositories created in the last 7 days. The same list as Upstar's Trending page.
Input Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"description": "language of the names, descriptions and links Upstar writes: en (default at /mcp) or fr (default at /fr/mcp); repository descriptions stay as their authors wrote them",
"enum": [
"en",
"fr"
]
},
"detail": {
"type": "string",
"description": "compact (the default): each repository's rank, name, description, language, stars, gains and Upstar page; full adds its creation day, health level, topics with their ranks and GitHub address, list_topics its categories, and get_repo its 12-week history, GitHub topics, activity counts and every period's ranks",
"default": "compact",
"enum": [
"compact",
"full"
]
},
"period": {
"type": "string",
"description": "day (last 24 hours), week (last 7 days, the default) or month (last 30 days); new_only is always the week",
"default": "week",
"enum": [
"day",
"week",
"month"
]
},
"sort": {
"type": "string",
"description": "velocity (stars gained relative to size, the default) or gained (most stars gained, so large repositories show)",
"default": "velocity",
"enum": [
"velocity",
"gained"
]
},
"new_only": {
"type": "boolean",
"description": "only repositories created in the last 7 days, by stars gained this week"
},
"limit": {
"type": "integer",
"description": "how many repositories, 1 to 50 (10 by default)",
"default": 10,
"minimum": 1,
"maximum": 50
},
"offset": {
"type": "integer",
"description": "how many places of the ranking to pass over, for the next page (next_offset of the previous answer); 0 by default, at most the number of repositories ranked",
"default": 0,
"minimum": 0,
"maximum": 10000
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"data_updated_at": {
"type": "string",
"description": "when Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then"
},
"method_url": {
"type": "string",
"description": "Upstar's page explaining how stars are counted and repositories ranked"
},
"source": {
"type": "string",
"description": "the source to cite when using these figures"
},
"lang": {
"type": "string",
"description": "language of names and descriptions written by Upstar (en or fr)"
},
"period": {
"type": "string"
},
"ranked": {
"type": "integer",
"description": "how many repositories this ranking holds"
},
"repos": {
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"rank": {
"type": "integer",
"description": "its rank in this list (a topic ranking keeps the topic's own ranks)"
},
"full_name": {
"type": "string",
"description": "owner/name as GitHub writes it"
},
"description": {
"type": "string",
"description": "the repository's GitHub description, as its authors wrote it"
},
"language": {
"type": "string"
},
"stars": {
"type": "integer",
"description": "GitHub's star count as Upstar last read it"
},
"stars_gained": {
"type": "object",
"properties": {
"last_24h": {
"type": "integer"
},
"last_7d": {
"type": "integer"
},
"last_30d": {
"type": "integer"
}
},
"required": [
"last_24h",
"last_7d",
"last_30d"
],
"additionalProperties": false
},
"created_on": {
"type": "string",
"description": "creation day (YYYY-MM-DD; full detail)"
},
"new": {
"type": "boolean",
"description": "created in the last 30 days"
},
"health": {
"type": "string",
"description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)"
},
"topics": {
"description": "its topics with its rank there this week (full detail)",
"anyOf": [
{
"type": "null"
},
{
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"rank_this_week": {
"type": "integer"
},
"url": {
"type": "string"
}
},
"required": [
"slug",
"name",
"url"
],
"additionalProperties": false
}
}
]
},
"url": {
"type": "string",
"description": "the repository's page on Upstar"
},
"github_url": {
"type": "string",
"description": "full detail"
}
},
"required": [
"full_name",
"stars",
"stars_gained",
"url"
],
"additionalProperties": false
}
}
]
},
"next_offset": {
"type": "integer",
"description": "the offset of the next page; absent on the last one"
}
},
"required": [
"data_updated_at",
"method_url",
"source",
"lang",
"period",
"ranked",
"repos"
],
"additionalProperties": false
}Community
Evidence