Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

listFeatures/getFeatureExamples never return Kotlin examples for Android or server Kotlin SDKs

Open Beginner friendly
#23 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
68/100
Issue type
Bug
Clarity
Clearly specified
Activity status
Active
Tech stack
node.js, typescript
Domain
api, backend

Research direction

Start by reading the listFeatures and getFeatureExamples tool handlers and the library data they search; the issue identifies the lookup by root as the source of the Java/Kotlin collision. Check how the input schema’s accepted libraryId values map to library entries, then run or add a regression test for both Android and server Kotlin examples. Done means every accepted library ID resolves and the Kotlin requests return Kotlin examples.

Written by the indexing model from the issue text.

Description

👟 Reproduction steps
  1. Connect to the docs MCP server and call tools/list. The listFeatures description lists both Android - Java (ID: client-android) and Android - Kotlin (ID: client-android), and both Kotlin - Java and Kotlin - Kotlin as server-kotlin.
  2. Call getFeatureExamples with {"libraryId":"client-android","feature":"account"}.
  3. Call listFeatures with {"libraryId":"client-android-kotlin"}. This value is in the tool's input enum.
👍 Expected behavior

There is a way to get the Kotlin examples for Android and for the server Kotlin SDK. Every libraryId the schema accepts resolves to a library.

👎 Actual Behavior
  • Step 2 always returns Reference: Android - Java / account, i.e. Java code. The Kotlin variant can't be reached because both variants share root: "client-android" and the tools look the library up with librariesWithFeatures.find((l) => l.root === input.libraryId), which returns the first (Java) entry. server-kotlin has the same problem.
  • Step 3 returns Internal Server Error: Could not fetch features for library "client-android-kotlin". client-android-java behaves the same way.

So anyone asking for Kotlin examples (the default language for Android) gets Java code.

🎲 Appwrite version

Appwrite Cloud

💻 Operating system

MacOS

🧱 Your Environment

appwrite/mcp-for-docs main @ 4909af6 (v1.0.7), run locally with node dist/index.js.

👀 Have you spent some time to check if this issue has been raised before?
  • I checked and didn't find similar issue
🏢 Have you read the Code of Conduct?

I have a fix with a regression test ready. Could this be assigned to me so I can open a PR?

Dominant language
TypeScript
Stars
11
Forks
5
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from appwrite/mcp-for-docs

All issues in appwrite/mcp-for-docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.