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

Add ContextFetch web search MCP to the integrations catalog

Open Beginner friendly
  • Is something wrong?
#829 1 comment 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript, node.js
Domain
tooling

Research direction

Read integrations/catalog/exa.json and integrations/catalog/tavily.json to follow the catalog entry shape, then inspect the integration build script or package task used by npm run build:integrations. Add the ContextFetch entry and regenerate catalog-index.js; done when it appears alongside the existing web search integrations and the generated catalog is current. The issue notes account management tools that can change billing settings, so confirm their inclusion with the maintainer during review.

Written by the indexing model from the issue text.

Description

priority:low

Request

Add ContextFetch to the integrations catalog (integrations/catalog/) so it appears on the OpenHands MCP page next to the existing web search entries (Tavily, Exa, Brave Search, Kagi).

What ContextFetch provides

  • Web search and page-contents API for agents (no LLM in the pipeline; results are ranked passages and Markdown). API base: https://api.contextfetch.dev. Docs: https://contextfetch.dev/docs
  • MCP server published on npm as @contextfetch/mcp (stdio, Node >= 18), run with npx -y @contextfetch/mcp.
  • Auth: CONTEXTFETCH_API_KEY environment variable. Without it the server falls back to a keyless tier limited to 25 requests/day per IP.
  • Tools exposed by @contextfetch/[email protected]: contextfetch_search, contextfetch_extract_url, contextfetch_find_similar, contextfetch_research, contextfetch_deep_research, contextfetch_answer, contextfetch_crawl, contextfetch_map, contextfetch_balance, contextfetch_auto_reload, contextfetch_get_free_key.
    • Note for review: contextfetch_auto_reload can change the account's credit auto-reload settings (card saved at checkout, capped at $500/month), and contextfetch_get_free_key requests a free key. If that is not wanted in the catalog default, say so and we can add a flag to the server to omit account-management tools.

Proposed catalog entry

integrations/catalog/contextfetch.json, same shape as exa.json / tavily.json: one api connection option, provider: "mcp", stdio transport, command: "npx", args: ["-y", "@contextfetch/mcp"], one envFields entry CONTEXTFETCH_API_KEY (type: "password", required: true, helper link to https://contextfetch.dev), auth.strategy: "api_key". docsUrl: https://github.com/lachy3433/contextfetch-mcp. catalog-index.js regenerated with npm run build:integrations.

The key is marked required to match the other search entries and avoid sending queries anonymously, even though the server can run keyless.

Verification done

Ran the published package over stdio with a test key (initialize, tools/list, then tools/call contextfetch_search with query: "OpenHands software agent SDK"): tools/list returned the tools above, and the search returned results with isError: false (first hit https://docs.openhands.dev/sdk).

Disclosure

Opened on behalf of the ContextFetch maintainer. A PR can follow once this is triaged; per the PR template, the HUMAN: testing note would be written by the maintainer.

Dominant language
Python
Stars
172
Forks
117
Avg merge
1d 20h
Merged PRs (30d)
65

Getting set up

  • No Dockerfile or Docker Compose file
  • Has a pull request template
  • No contributing guide

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 OpenHands/extensions

All issues in OpenHands/extensions

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.