Skip to main content
Glama

Spotted early by Upstar

spotted_early
Read-onlyIdempotent

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

NameRequiredDescriptionDefault
langNolanguage 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
limitNohow many repositories, 1 to 50 (10 by default)
detailNocompact (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 rankscompact

Output Schema

NameRequiredDescriptionDefault
langYeslanguage of names and descriptions written by Upstar (en or fr)
reposYes
sourceYesthe source to cite when using these figures
method_urlYesUpstar's page explaining how stars are counted and repositories ranked
data_updated_atYeswhen Upstar last rebuilt its rankings from GitHub's data (UTC, RFC 3339): every figure is as of then

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / repos / anyOf
      Previous value: -[
      -  {
      -    "type": "null"
      -  },
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "created_on": {
      -          "description": "creation day (YYYY-MM-DD; full detail)",
      -          "type": "string"
      -        },
      -        "description": {
      -          "description": "the repository's GitHub description, as its authors wrote it",
      -          "type": "string"
      -        },
      -        "full_name": {
      -          "description": "owner/name as GitHub writes it",
      -          "type": "string"
      -        },
      -        "github_url": {
      -          "description": "full detail",
      -          "type": "string"
      -        },
      -        "health": {
      -          "description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)",
      -          "type": "string"
      -        },
      -        "language": {
      -          "type": "string"
      -        },
      -        "new": {
      -          "description": "created in the last 30 days",
      -          "type": "boolean"
      -        },
      -        "rank": {
      -          "description": "its rank in this list (a topic ranking keeps the topic's own ranks)",
      -          "type": "integer"
      -        },
      -        "rank_when_spotted": {
      -          "description": "its rank in that topic's weekly ranking then, any rank; absent when not kept (before November 2026)",
      -          "type": "integer"
      -        },
      -        "spotted_in": {
      -          "additionalProperties": false,
      -          "description": "the topic it was first ranked in",
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "rank_this_week": {
      -              "type": "integer"
      -            },
      -            "slug": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "slug",
      -            "name",
      -            "url"
      -          ],
      -          "type": "object"
      -        },
      -        "spotted_on": {
      -          "description": "the day Upstar first ranked it (YYYY-MM-DD)",
      -          "type": "string"
      -        },
      -        "stars": {
      -          "description": "GitHub's star count as Upstar last read it",
      -          "type": "integer"
      -        },
      -        "stars_gained": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "last_24h": {
      -              "type": "integer"
      -            },
      -            "last_30d": {
      -              "type": "integer"
      -            },
      -            "last_7d": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "last_24h",
      -            "last_7d",
      -            "last_30d"
      -          ],
      -          "type": "object"
      -        },
      -        "stars_when_spotted": {
      -          "type": "integer"
      -        },
      -        "topics": {
      -          "anyOf": [
      -            {
      -              "type": "null"
      -            },
      -            {
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "name": {
      -                    "type": "string"
      -                  },
      -                  "rank_this_week": {
      -                    "type": "integer"
      -                  },
      -                  "slug": {
      -                    "type": "string"
      -                  },
      -                  "url": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "slug",
      -                  "name",
      -                  "url"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            }
      -          ],
      -          "description": "its topics with its rank there this week (full detail)"
      -        },
      -        "url": {
      -          "description": "the repository's page on Upstar",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "full_name",
      -        "stars",
      -        "stars_gained",
      -        "url",
      -        "spotted_on",
      -        "spotted_in",
      -        "stars_when_spotted"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "null"
      +  },
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "created_on": {
      +          "description": "creation day (YYYY-MM-DD; full detail)",
      +          "type": "string"
      +        },
      +        "description": {
      +          "description": "the repository's GitHub description, as its authors wrote it",
      +          "type": "string"
      +        },
      +        "full_name": {
      +          "description": "owner/name as GitHub writes it",
      +          "type": "string"
      +        },
      +        "github_url": {
      +          "description": "full detail",
      +          "type": "string"
      +        },
      +        "health": {
      +          "description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)",
      +          "type": "string"
      +        },
      +        "language": {
      +          "type": "string"
      +        },
      +        "new": {
      +          "description": "created in the last 30 days",
      +          "type": "boolean"
      +        },
      +        "rank": {
      +          "description": "its rank in this list (a topic ranking keeps the topic's own ranks)",
      +          "type": "integer"
      +        },
      +        "rank_when_spotted": {
      +          "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",
      +          "type": "integer"
      +        },
      +        "spotted_in": {
      +          "anyOf": [
      +            {
      +              "type": "null"
      +            },
      +            {
      +              "additionalProperties": false,
      +              "properties": {
      +                "name": {
      +                  "type": "string"
      +                },
      +                "rank_this_week": {
      +                  "type": "integer"
      +                },
      +                "slug": {
      +                  "type": "string"
      +                },
      +                "url": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "slug",
      +                "name",
      +                "url"
      +              ],
      +              "type": "object"
      +            }
      +          ],
      +          "description": "the topic it was first ranked in; absent when the repo has left that topic"
      +        },
      +        "spotted_on": {
      +          "description": "the day Upstar first ranked it (YYYY-MM-DD)",
      +          "type": "string"
      +        },
      +        "stars": {
      +          "description": "GitHub's star count as Upstar last read it",
      +          "type": "integer"
      +        },
      +        "stars_gained": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "last_24h": {
      +              "type": "integer"
      +            },
      +            "last_30d": {
      +              "type": "integer"
      +            },
      +            "last_7d": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "last_24h",
      +            "last_7d",
      +            "last_30d"
      +          ],
      +          "type": "object"
      +        },
      +        "stars_when_spotted": {
      +          "type": "integer"
      +        },
      +        "topics": {
      +          "anyOf": [
      +            {
      +              "type": "null"
      +            },
      +            {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "rank_this_week": {
      +                    "type": "integer"
      +                  },
      +                  "slug": {
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "slug",
      +                  "name",
      +                  "url"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          ],
      +          "description": "its topics with its rank there this week (full detail)"
      +        },
      +        "url": {
      +          "description": "the repository's page on Upstar",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "full_name",
      +        "stars",
      +        "stars_gained",
      +        "url",
      +        "spotted_on",
      +        "stars_when_spotted"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  }
      +]
  2. Changed1 schema field changed
    • changedOutput schema / properties / repos / anyOf
      Previous value: -[
      -  {
      -    "type": "null"
      -  },
      -  {
      -    "items": {
      -      "additionalProperties": false,
      -      "properties": {
      -        "created_on": {
      -          "description": "creation day (YYYY-MM-DD; full detail)",
      -          "type": "string"
      -        },
      -        "description": {
      -          "description": "the repository's GitHub description, as its authors wrote it",
      -          "type": "string"
      -        },
      -        "full_name": {
      -          "description": "owner/name as GitHub writes it",
      -          "type": "string"
      -        },
      -        "github_url": {
      -          "description": "full detail",
      -          "type": "string"
      -        },
      -        "health": {
      -          "description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)",
      -          "type": "string"
      -        },
      -        "language": {
      -          "type": "string"
      -        },
      -        "new": {
      -          "description": "created in the last 30 days",
      -          "type": "boolean"
      -        },
      -        "rank": {
      -          "description": "its rank in this list (a topic ranking keeps the topic's own ranks)",
      -          "type": "integer"
      -        },
      -        "spotted_in": {
      -          "additionalProperties": false,
      -          "description": "the topic it was first ranked in",
      -          "properties": {
      -            "name": {
      -              "type": "string"
      -            },
      -            "rank_this_week": {
      -              "type": "integer"
      -            },
      -            "slug": {
      -              "type": "string"
      -            },
      -            "url": {
      -              "type": "string"
      -            }
      -          },
      -          "required": [
      -            "slug",
      -            "name",
      -            "url"
      -          ],
      -          "type": "object"
      -        },
      -        "spotted_on": {
      -          "description": "the day Upstar first ranked it (YYYY-MM-DD)",
      -          "type": "string"
      -        },
      -        "stars": {
      -          "description": "GitHub's star count as Upstar last read it",
      -          "type": "integer"
      -        },
      -        "stars_gained": {
      -          "additionalProperties": false,
      -          "properties": {
      -            "last_24h": {
      -              "type": "integer"
      -            },
      -            "last_30d": {
      -              "type": "integer"
      -            },
      -            "last_7d": {
      -              "type": "integer"
      -            }
      -          },
      -          "required": [
      -            "last_24h",
      -            "last_7d",
      -            "last_30d"
      -          ],
      -          "type": "object"
      -        },
      -        "stars_when_spotted": {
      -          "type": "integer"
      -        },
      -        "topics": {
      -          "anyOf": [
      -            {
      -              "type": "null"
      -            },
      -            {
      -              "items": {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "name": {
      -                    "type": "string"
      -                  },
      -                  "rank_this_week": {
      -                    "type": "integer"
      -                  },
      -                  "slug": {
      -                    "type": "string"
      -                  },
      -                  "url": {
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "slug",
      -                  "name",
      -                  "url"
      -                ],
      -                "type": "object"
      -              },
      -              "type": "array"
      -            }
      -          ],
      -          "description": "its topics with its rank there this week (full detail)"
      -        },
      -        "url": {
      -          "description": "the repository's page on Upstar",
      -          "type": "string"
      -        }
      -      },
      -      "required": [
      -        "full_name",
      -        "stars",
      -        "stars_gained",
      -        "url",
      -        "spotted_on",
      -        "spotted_in",
      -        "stars_when_spotted"
      -      ],
      -      "type": "object"
      -    },
      -    "type": "array"
      -  }
      -]New value: +[
      +  {
      +    "type": "null"
      +  },
      +  {
      +    "items": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "created_on": {
      +          "description": "creation day (YYYY-MM-DD; full detail)",
      +          "type": "string"
      +        },
      +        "description": {
      +          "description": "the repository's GitHub description, as its authors wrote it",
      +          "type": "string"
      +        },
      +        "full_name": {
      +          "description": "owner/name as GitHub writes it",
      +          "type": "string"
      +        },
      +        "github_url": {
      +          "description": "full detail",
      +          "type": "string"
      +        },
      +        "health": {
      +          "description": "Upstar's health level: healthy, mixed, low, new or archived (full detail; empty when not assessed)",
      +          "type": "string"
      +        },
      +        "language": {
      +          "type": "string"
      +        },
      +        "new": {
      +          "description": "created in the last 30 days",
      +          "type": "boolean"
      +        },
      +        "rank": {
      +          "description": "its rank in this list (a topic ranking keeps the topic's own ranks)",
      +          "type": "integer"
      +        },
      +        "rank_when_spotted": {
      +          "description": "its rank in that topic's weekly ranking then, any rank; absent when not kept (before November 2026)",
      +          "type": "integer"
      +        },
      +        "spotted_in": {
      +          "additionalProperties": false,
      +          "description": "the topic it was first ranked in",
      +          "properties": {
      +            "name": {
      +              "type": "string"
      +            },
      +            "rank_this_week": {
      +              "type": "integer"
      +            },
      +            "slug": {
      +              "type": "string"
      +            },
      +            "url": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "slug",
      +            "name",
      +            "url"
      +          ],
      +          "type": "object"
      +        },
      +        "spotted_on": {
      +          "description": "the day Upstar first ranked it (YYYY-MM-DD)",
      +          "type": "string"
      +        },
      +        "stars": {
      +          "description": "GitHub's star count as Upstar last read it",
      +          "type": "integer"
      +        },
      +        "stars_gained": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "last_24h": {
      +              "type": "integer"
      +            },
      +            "last_30d": {
      +              "type": "integer"
      +            },
      +            "last_7d": {
      +              "type": "integer"
      +            }
      +          },
      +          "required": [
      +            "last_24h",
      +            "last_7d",
      +            "last_30d"
      +          ],
      +          "type": "object"
      +        },
      +        "stars_when_spotted": {
      +          "type": "integer"
      +        },
      +        "topics": {
      +          "anyOf": [
      +            {
      +              "type": "null"
      +            },
      +            {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "rank_this_week": {
      +                    "type": "integer"
      +                  },
      +                  "slug": {
      +                    "type": "string"
      +                  },
      +                  "url": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "slug",
      +                  "name",
      +                  "url"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          ],
      +          "description": "its topics with its rank there this week (full detail)"
      +        },
      +        "url": {
      +          "description": "the repository's page on Upstar",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "full_name",
      +        "stars",
      +        "stars_gained",
      +        "url",
      +        "spotted_on",
      +        "spotted_in",
      +        "stars_when_spotted"
      +      ],
      +      "type": "object"
      +    },
      +    "type": "array"
      +  }
      +]
  3. First observed

TDQS

B3.1/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is covered. The description adds genuinely useful behavior beyond that — the result is ordered by most growth first — but says nothing about pagination, time windows, or how 'first ranked' is determined. Adequate but thin against a low annotation bar.

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

Conciseness3/5

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

The core rule is front-loaded, but the phrasing is tangled: 'at any rank: when, in which topic and at which rank it first ranked them' repeats rank and is hard to parse as return fields. The trailing fragment 'Most grown first: the same list as Upstar's Spotted early page' splits ordering and provenance awkwardly.

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

Completeness3/5

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

An output schema exists, so return shape need not be spelled out, and the description correctly covers the selection rule and sort order. What is missing for a discovery tool surrounded by eight siblings is where it fits — no stated relationship to emerging, trending or topic_ranking, and no note on the default 10-item limit's implications.

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 100%, and the schema already explains lang, limit and the compact/full detail levels in more depth than the description does. The description adds no parameter meaning at all, so the baseline 3 applies.

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

Purpose4/5

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

The description names the specific resource and its selection rule: repositories whose stars at least doubled since Upstar first ranked them in a topic. That is a real verb-plus-resource statement an agent can act on, but it never contrasts the set with siblings like emerging or trending, so differentiation is left implicit.

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

Usage Guidelines2/5

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

There is no when-to-use or when-not-to-use guidance and no alternative named. The closing clause 'the same list as Upstar's Spotted early page' describes provenance/ordering rather than telling an agent when this tool beats emerging, trending or topic_ranking.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources