Skip to main content
Glama

Server Details

MCP server for Cursor/Claude Code: paste a JD or README, get ranked engineers by verified work.

Status
Healthy
Last Tested
Transport
Streamable HTTP
URL

Glama MCP Gateway

Connect through Glama MCP Gateway for full control over tool access and complete visibility into every call.

MCP client
Glama
MCP server

Full call logging

Every tool call is logged with complete inputs and outputs, so you can debug issues and audit what your agents are doing.

Tool access control

Enable or disable individual tools per connector, so you decide what your agents can and cannot do.

Managed credentials

Glama handles OAuth flows, token storage, and automatic rotation, so credentials never expire on your clients.

Usage analytics

See which tools your agents call, how often, and when, so you can understand usage patterns and catch anomalies.

100% free. Your data is private.
Tool DescriptionsA

Average 4.7/5 across 3 of 3 tools scored.

Server CoherenceA
Disambiguation5/5

Each tool targets a distinct operation: finding candidates by job description, finding similar projects to a repo, and fetching individual profiles. No overlap in purpose.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern using snake_case: find_candidates, find_similar_projects, get_profile. Predictable and clear.

Tool Count4/5

With 3 tools, the set is slightly small but still covers the core functionalities of candidate search, project exploration, and profile lookup. It's reasonable for a focused server.

Completeness4/5

The tool surface covers the main needs: searching candidates (with full profile data embedded), finding similar projects, and fetching individual profiles. Minor gaps like filtering or updating do not hinder the core matching workflow.

Available Tools

3 tools
find_candidatesA
Read-onlyIdempotent
Inspect

Search the DevMatch index for engineers matching a job description. Pass JD text — formal description, informal request, role brief, paste of a README, or anything in between. The longer + more specific, the better the match. Returns ranked candidates with FULL profile data inline per result: handle, name, bio, location, followers, top_repos, top_topics, matched_projects (with contribution counts), contact info (email + social URLs when available), and candidate_score. You do NOT need to call get_profile for candidates returned here — their profiles are already embedded in the response. Only call get_profile when the user asks about a handle that was NOT in the find_candidates results.

Public github.com repo URLs are also accepted as input (server fetches README + topics + language and uses it as the JD), but ONLY for PUBLIC repos. For private repos, paste the README content directly as the JD string.

ParametersJSON Schema
NameRequiredDescriptionDefault
inputYesJob description text (preferred), OR a PUBLIC github.com repo URL. For private repos, paste the README content as text instead of the URL. The richer the input, the better the ranking.

Output Schema

ParametersJSON Schema
NameRequiredDescription
query_msNoEnd-to-end query time in milliseconds
candidatesYesRanked engineer candidates. Highest candidate_score first.
total_countYesCount of candidates returned (≤ requested limit)
cache_sourceNo
Behavior5/5

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

Annotations (readOnlyHint, idempotentHint, destructiveHint) indicate safe, non-destructive operation. The description adds substantial context: it describes the response structure (ranked candidates with full profile data inline per result), states you don't need to call get_profile, and clarifies accepted input types and their limits. No contradictions with annotations.

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 well-structured and front-loaded with the core purpose. Every sentence contributes essential information: input types, best practices, output details, and differentiation from sibling tools. Despite its length, it is efficient and avoids redundancy.

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?

For a tool with 1 parameter and rich output (implied by 'full profile data inline', matched_projects, contact info), the description fully explains input expectations, output content, and behavioral nuances (repo URL handling). It covers all aspects an agent needs to use the tool correctly without additional lookups.

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

Parameters5/5

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

The single parameter 'input' has 100% schema description coverage, but the description significantly expands its meaning: it explains the flexibility of input (formal JD, informal request, README paste, etc.), the advantage of length and specificity, and the special case of public repo URLs vs. private repos. This adds crucial semantic context beyond the schema.

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 clearly states the tool's purpose: 'Search the DevMatch index for engineers matching a job description.' It specifies the action (search), resource (DevMatch index), and expected outcome (engineers matching JD). It also differentiates from sibling tools by noting that returned candidates include full profiles, so get_profile is unnecessary.

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?

The description provides explicit when-to-use guidance (pass JD text or public repo URL) and when-not-to-use (do not call get_profile for candidates returned here). It also explains alternatives for different input types (private repos: paste README instead of URL). This clearly distinguishes from siblings like get_profile.

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

find_similar_projectsA
Read-onlyIdempotent
Inspect

Find open-source projects similar to a given GitHub repo, ranked by semantic similarity to its description/topics/README. Each result includes the project's top contributors so the caller can pivot from a project to its maintainers in one step. Use for landscape mapping ("what else is like X?"), competitive intel, or to expand a candidate search past a single anchor project.

ParametersJSON Schema
NameRequiredDescriptionDefault
repoYesSeed repo in `owner/name` form (e.g. 'karpathy/llm.c'). A full github.com URL is also accepted; the server strips the prefix.
limitNoNumber of similar projects to return. Defaults to 10, max 25.

Output Schema

ParametersJSON Schema
NameRequiredDescription
projectsYesSimilar projects, ranked by vector similarity to the seed repo.
seed_repoNoThe owner/name that was searched against
Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint, idempotentHint, and destructiveHint. The description adds value beyond these by explaining the ranking method (semantic similarity) and the inclusion of top contributors in results. It also clarifies that the tool operates on GitHub repositories and outputs an ordered list, which is not covered by annotations.

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 three sentences, each serving a distinct purpose: first sentence states core functionality, second highlights key output feature (contributors), third lists use cases. It is front-loaded with the main action, no redundant words, and every sentence adds value. It is highly efficient and well-structured.

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

Completeness4/5

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

Given the tool's simplicity (takes a repo and limit, returns similar projects with contributors) and the presence of an output schema, the description covers all essential aspects: input, output, ranking method, and inclusion of contributors. It does not discuss error handling, but those are generally not expected. The use cases provide additional context. Slightly incomplete regarding potential edge cases (e.g., no results), but overall sufficient.

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%, so baseline is 3. The description does not add parameter-specific details beyond what the schema provides. The description mentions ranking by similarity but does not explain how parameters like 'limit' affect the score or behavior. The schema already adequately documents both parameters, so the description does not require additional semantics.

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 clearly states the tool finds open-source projects similar to a given GitHub repo using semantic similarity. It specifies the verb 'Find', the resource 'similar projects', and the method 'semantic similarity to its description/topics/README'. The use cases (landscape mapping, competitive intel, candidate expansion) further clarify purpose. It is well-differentiated from siblings like find_candidates (which presumably finds candidates generally) and get_profile (which retrieves profile details).

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

Usage Guidelines4/5

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

The description explicitly lists three concrete use cases: landscape mapping, competitive intel, and candidate search expansion. This provides clear context for when to use the tool. However, it does not explicitly state when not to use it or compare it to alternatives like find_candidates, leaving the agent to infer boundaries. The guidance is clear but not exhaustive.

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

get_profileA
Read-onlyIdempotent
Inspect

Fetch one contributor's profile card when the user mentions a specific GitHub handle that was NOT already returned by find_candidates. Use cases: (a) user types 'tell me about @karpathy'; (b) user references a handle they found elsewhere; (c) user wants to verify someone before outreach. Do NOT call this immediately after find_candidates for handles in those results — find_candidates already returns full profile data inline per candidate (bio, location, contact, top_repos, top_topics).

IMPORTANT — interpreting recent_activities: this field reflects indexed GitHub activity in the current ingestion window (2025–2026), up to ~20 events per recent project. It is NOT a complete career history. Older or empty activity does not mean the person is inactive; they may be outside the index window or not yet enriched. Do not infer tenure or 'last active' from activity older than 2025.

ParametersJSON Schema
NameRequiredDescriptionDefault
handleYesThe GitHub handle to look up. Plain login name, no '@' prefix (e.g. 'karpathy', not '@karpathy').

Output Schema

ParametersJSON Schema
NameRequiredDescription
bioNo
nameNo
emailNo
companyNo
html_urlNoProfile URL on GitHub
locationNo
followersNo
avatar_urlNo
login_nameYesGitHub handle
display_nameNo
public_reposNo
top_projectsNoHighest-contribution projects this user worked on
profile_readmeNoUser's profile README content if present
social_accountsNoSocial URLs (twitter, linkedin, etc.)
recent_activitiesNoIndexed GitHub events from current ingestion window (2025–2026). NOT a full career timeline.
Behavior5/5

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

Annotations indicate readOnlyHint, openWorldHint, idempotentHint, and destructiveHint false. The description adds critical context about 'recent_activities': it reflects only 2025–2026 indexed activity (~20 events per project) and is not a complete career history. It also warns against inferring inactivity from missing or old data, going well beyond the structured annotations.

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 concise, front-loading the purpose and use cases, then providing important caveats about data freshness. Every sentence adds value without redundancy. Ideally sized for quick comprehension.

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?

Given the presence of an output schema and annotations, the description covers all necessary aspects: invocation context, parameter format, data limitations, and behavioral notes. There are no gaps for a tool of this complexity.

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

Parameters4/5

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

Schema coverage is 100% with clear description for the single 'handle' parameter. The description adds practical guidance (plain login name, no '@' prefix), which is useful but not essential given the schema. Minor added value justifies a slight bonus above baseline 3.

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 clearly states the tool fetches a contributor's profile card for a specific GitHub handle, with explicit use cases (e.g., user mentions a handle, references from elsewhere, verification). It distinguishes itself from the sibling 'find_candidates' by noting that find_candidates already returns full profile data for handles in its results.

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?

Provides explicit guidance on when to use (e.g., handle not in find_candidates results) and when not to (do not call immediately after find_candidates for handles already returned). Lists three specific use cases, giving clear context for invocation.

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

Discussions

No comments yet. Be the first to start the discussion!

Try in Browser

Your Connectors

Sign in to create a connector for this server.

Resources