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

examples/client: add a remote search and fetch example with Parallel MCP

Open Beginner friendly
  • Is something wrong?
#1,372 0 comments 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
76/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
go
Domain
tooling

Research direction

Start in examples/client/ and read the existing listfeatures and loadtest examples to see how they use StreamableClientTransport and CallTool. Then add a focused example for https://search.parallel.ai/mcp that discovers and calls web_search or web_fetch; include setup instructions, timeout and error handling, and tests with a local MCP server. Done means the documented commands work against the anonymous endpoint and the tests cover both tool calls.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem? Please describe.
The client examples cover remote feature discovery, HTTP load testing, and calls to a local HTTP server. A focused example for one remote search or page-fetch call would make it easier to learn tool discovery, invocation, and result handling without configuring a load test.

Describe the solution you'd like
Add a small example under examples/client/ using the existing StreamableClientTransport and CallTool APIs with Parallel Search MCP at https://search.parallel.ai/mcp. It would accept a search query or page URL, discover the tools, invoke web_search or web_fetch, and print the returned content. The service provides free, keyless search in Fast mode and page fetching, with anonymous rate limits.

Keep this confined to the example, with no SDK API changes or new dependencies. Include setup instructions, a bounded request timeout, error handling, and tests using a local MCP server. Validate both documented commands against the anonymous endpoint before submitting the implementation.

Describe alternatives you've considered
examples/client/listfeatures already accepts a remote HTTP endpoint, but only lists features. examples/http demonstrates tool calls against a local server. examples/client/loadtest can call a remote tool with JSON arguments, but is designed for repeated concurrent calls and throughput statistics. The proposed example would focus on a single search or page fetch and readable output.

Additional context
This issue precedes implementation as requested by the contribution guide for nontrivial changes. I work at Parallel. AI assistance was used to research the repository and draft this issue.

Dominant language
Go
Stars
5.2k
Forks
583
Avg merge
1d 11h
Merged PRs (30d)
47

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

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 modelcontextprotocol/go-sdk

All issues in modelcontextprotocol/go-sdk

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.