Skip to content

feat(mcp): add Olostep as a default web data MCP server#8301

Open
awais-yousaf75 wants to merge 4 commits into
janhq:mainfrom
awais-yousaf75:awais-yousaf75-patch-1
Open

feat(mcp): add Olostep as a default web data MCP server#8301
awais-yousaf75 wants to merge 4 commits into
janhq:mainfrom
awais-yousaf75:awais-yousaf75-patch-1

Conversation

@awais-yousaf75

Copy link
Copy Markdown

What

Adds Olostep as a default MCP server in DEFAULT_MCP_CONFIG
(src-tauri/src/core/mcp/constants.rs), alongside the existing web-search/scrape
servers like exa and serper.

Olostep is a web data API for AI agents — it can search the web, scrape any URL into
clean Markdown/HTML/JSON, crawl entire sites, batch-process large URL sets, and return
cited AI answers, all through one API.

Why

Jan already ships third-party web-data servers (exa, serper) as defaults. Olostep
gives users another out-of-the-box option for pulling live web data into local models,
with no extra setup beyond their own API key.

Changes

  • Single entry added to DEFAULT_MCP_CONFIG, modeled on the existing serper block.
  • Runs via npx -y olostep-mcp (published on npm as olostep-mcp).
  • active: false by default — users enable it and supply their own OLOSTEP_API_KEY
    (free key at https://www.olostep.com/auth).
  • No frontend changes: the Connectors/MCP Servers UI lists servers dynamically from this config.

Testing

  • Config still parses as valid JSON (test_default_mcp_config_parses_as_valid_json).
  • The new entry has the required command, args, and active fields
    (test_default_mcp_config_servers_have_required_fields).

@tokamak-pm

tokamak-pm Bot commented Jun 11, 2026

Copy link
Copy Markdown

PR Review: feat(mcp): add Olostep as a default web data MCP server

Recommendation: fix needed

Summary

This PR adds Olostep as a new entry in DEFAULT_MCP_CONFIG inside src-tauri/src/core/mcp/constants.rs. The change is minimal (6 lines added, 0 deleted, 1 file changed).


Issues Found

1. Inconsistent JSON indentation (style/correctness)

The new olostep block uses a different indentation style from every other entry in the JSON. The existing servers all use 4-space indentation for inner keys, while the new block mixes 4-space outer indentation with 9-space inner indentation:

-  "olostep": {
-         "command": "npx",
-         "args": ["-y", "olostep-mcp"],
-         "env": { "OLOSTEP_API_KEY": "YOUR_OLOSTEP_API_KEY_HERE" },
-         "active": false
-       },

All other entries use consistent 4-space indentation:

    "serper": {
      "command": "npx",
      "args": ["-y", "serper-search-scrape-mcp-server"],
      "env": { "SERPER_API_KEY": "YOUR_SERPER_API_KEY_HERE" },
      "active": false
    },

Please align the indentation with the rest of the file.

2. Missing "env": {} pattern for empty-env servers / field consistency

All existing entries include a consistent set of fields. While the new entry does include env, several other entries that have required fields also include "type" or "official" only when applicable. That is fine. However, the inconsistent indentation makes this hard to review as-is and should be cleaned up first.

3. Strategic / vetting concern

This PR adds a third-party commercial service (Olostep) as a default bundled MCP server. The existing defaults (exa, serper, browsermcp, fetch, filesystem, sequential-thinking) were presumably vetted by the core team. From an outside contributor with no prior history in the repo, adding a commercial service with a paid API key to the default config warrants maintainer-level review to confirm:

  • Olostep has been evaluated and is acceptable to ship as a default (even disabled by default).
  • There is no conflict of interest — this PR comes from an account with no prior contributions to the repo.
  • The olostep-mcp npm package is trustworthy and actively maintained (currently at v0.0.2 on npm as of writing).

4. No "type" field

The exa entry uses "type": "http" to signal it is an HTTP-transport MCP server. Other stdio-based servers omit this field, which appears to be the convention. The new entry correctly omits it, so this is not a blocker — just confirming the pattern is intentional.

5. npx without a pinned version

The args use ["-y", "olostep-mcp"] with no @version pin. Other entries like serper and browsermcp also follow this pattern, so this is consistent with existing convention. Still worth noting that unpinned packages carry a supply-chain risk.


What must be fixed before merging

  1. Fix indentation — the new JSON block must use consistent 2-space indentation (matching the rest of the DEFAULT_MCP_CONFIG literal) so the embedded JSON stays well-formatted and readable.

What maintainers should decide

  1. Vendor vetting — confirm that Olostep is an appropriate addition to the default server list given this is a commercial third-party service added by a first-time external contributor.

What is done well

  • active: false by default — users must explicitly enable it and supply their own API key. No credentials are committed.
  • The PR description is clear and explains the motivation.
  • The change is small and scoped to a single file.
  • The existing tests (test_default_mcp_config_parses_as_valid_json, test_default_mcp_config_servers_have_required_fields) will catch structural regressions automatically.

@awais-yousaf75

Copy link
Copy Markdown
Author

Thanks for the detailed review! A few responses:

Indentation — Fixed. The olostep block now uses the same indentation as the other entries (matching the serper block).

Disclosure — For full transparency: I'm from the Olostep team, so I'm submitting this as the maintainer of the service rather than an unaffiliated contributor. Happy to provide whatever helps with vetting.

Package status — A small correction: olostep-mcp is actively maintained and currently at v1.0.16 on npm (16 releases since March 2025, last published this week), not v0.0.2.

Safety defaults — As noted, the entry is active: false by default, so users must explicitly enable it and supply their own OLOSTEP_API_KEY. No credentials are committed.

Let me know if there's anything else you'd like for the maintainer review 🙏

@tokamak-pm

tokamak-pm Bot commented Jun 12, 2026

Copy link
Copy Markdown

Follow-up review — new commit + author response since last review.

New commit reviewed

ecec9eb — "fix: align Olostep block indentation with other entries"

The indentation issue from the first review is resolved. The olostep block now uses consistent 2-space indentation matching all other entries in DEFAULT_MCP_CONFIG.

Correction on package status

The author (from the Olostep team) correctly pointed out that olostep-mcp is at v1.0.16 on npm with 16 releases since March 2025 — not v0.0.2 as stated in our initial review. I apologize for the inaccurate version reference; the package is actively maintained with regular releases.

Updated assessment

Concern Status
Indentation consistency Fixed
Package maturity v1.0.16, actively maintained — concern resolved
active: false default Correct — users must opt in
No credentials committed Correct
Conflict of interest disclosure Author transparently disclosed Olostep affiliation

Remaining maintainer decision

The only open item is whether the project wants to include Olostep as a default (disabled) MCP server. This is a product/governance decision for the core team, not a code quality issue. The author has been transparent about their affiliation, which is appreciated.

Recommendation: can merge

The code change is correct, minimal, and well-structured. The indentation is fixed, the package is mature, and the entry is disabled by default. Pending maintainer approval of the vendor inclusion policy.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

1 participant