{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_rtzs6mspqfw9","handle":"oss-contribution-advisor-mcp","url":"https://wellknown.network/agents/oss-contribution-advisor-mcp","links":{"self":"https://wellknown.network/agents/oss-contribution-advisor-mcp/record.json","html":"https://wellknown.network/agents/oss-contribution-advisor-mcp","markdown":"https://wellknown.network/agents/oss-contribution-advisor-mcp/record.md","api":"https://wellknown.network/api/v1/agents/oss-contribution-advisor-mcp","status":"https://wellknown.network/api/v1/agents/oss-contribution-advisor-mcp/status","claim":"https://wellknown.network/agents/oss-contribution-advisor-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/oss-contribution-advisor-mcp/claim.json","badge":"https://wellknown.network/agents/oss-contribution-advisor-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:oss-contribution-advisor-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"oss-contribution-advisor-mcp","summary":"MCP server that helps developers find open-source issues worth contributing to — semantic issue search, repo health scoring, and downstream impact ranking.","description":"# OSS Contribution Advisor — MCP Server\n\nAn MCP server that helps developers find open-source issues genuinely worth\ncontributing to — not just issues tagged \"good first issue,\" but ones that\nmatch their interests, come from a healthy/responsive repo, and have real\ndownstream impact.\n\n## Why this exists\n\nExisting \"find your first OSS issue\" tools filter by label only. This server\nanswers three questions a label can't:\n\n1. **Does this match what I actually want to work on?** — semantic search\n   over open issues (local sentence-embeddings), not keyword/label matching.\n2. **Is this repo actually a good place to spend my time?** — health score\n   based on maintainer responsiveness and first-time-contributor merge rate.\n3. **Does this repo matter?** — ranks by *real* downstream reach via\n   [libraries.io](https://libraries.io)'s dependents graph (how many other\n   packages depend on this one) — not just GitHub stars.\n\n## Tools\n\n| Tool | Purpose |\n|---|---|\n| `match_issues_semantically` | Free-text interest → ranked list of matching open issues, using local sentence-embeddings. |\n| `score_repo_fit` | Given a repo, scores maintainer responsiveness, PR merge rate, doc completeness, and recent activity into a 0-100 fit score. |\n| `find_impact_multiplier_repos` | Ranks a given repo shortlist — or self-searches by language if none given — by real downstream dependents (libraries.io), falling back to a stars/forks proxy if unconfigured. |\n\n## Caching design\n\nTwo genuinely different cache policies, because the underlying data has two\ndifferent change patterns — using one TTL for everything would either waste\nAPI calls (too short) or serve stale data (too long):\n\n| Cache | Key | Lifetime | Why |\n|---|---|---|---|\n| **Search results** (`match_issues_semantically`) | GitHub search query string | 20 min TTL | Open issues genuinely change often, but repeated calls in a short window shouldn't re-hit the API. |\n| **Issue embeddings** (`match_issues_semantically`) | `(issue_id, update…","publisher":{"name":"Sonali","url":null},"homepage":"https://github.com/sonali1103/oss-contribution-advisor-mcp","repository":"https://github.com/sonali1103/oss-contribution-advisor-mcp","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["agentic-ai","github","mcp","model-context-protocol","open-source"],"pricing":null,"endpoints":[{"url":"pypi:oss-contribution-advisor-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"declared"},{"slug":"data.vector-search","name":"Vector Search","confidence":0.894,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"}],"categories":["data","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"oss-contribution-advisor-mcp","registry":"pypi","observedAt":"2026-09-10T09:26:44.320Z","publishedAt":"2026-08-20T17:52:03.930753Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"oss-contribution-advisor-mcp","url":"https://pypi.org/project/oss-contribution-advisor-mcp/","firstSeenAt":"2026-09-10T09:25:03.702Z","fetchedAt":"2026-09-10T09:25:03.702Z","normalizedAt":"2026-09-10T09:25:03.702Z"}]},"firstSeenAt":"2026-09-10T09:25:03.702Z","updatedAt":"2026-09-10T09:26:44.320Z"}