Skip to content

Default MCP search output to Markdown - #68

Open
Joseph-Mutua wants to merge 2 commits into
serpapi:mainfrom
Joseph-Mutua:feat/default-markdown-output-65
Open

Default MCP search output to Markdown#68
Joseph-Mutua wants to merge 2 commits into
serpapi:mainfrom
Joseph-Mutua:feat/default-markdown-output-65

Conversation

@Joseph-Mutua

@Joseph-Mutua Joseph-Mutua commented Sep 9, 2026

Copy link
Copy Markdown

Summary

  • default the search tool to Markdown when params.output is omitted
  • preserve explicit output="md" and output="json" behavior
  • keep MCP App tools on structured JSON
  • update regression coverage and documentation for the new default

Motivation

Markdown responses use substantially fewer context tokens for agent-oriented MCP usage, while callers that require machine-readable output can continue requesting output="json" explicitly.

Behavior

params.output Result
omitted Markdown
"md" Markdown
"json" JSON

MCP App tools continue forcing JSON internally.

Testing

  • uv run pytest -q
  • uv format --check
  • uv run --env-file .env pytest tests/test_integration.py -q
  • verified server /healthcheck locally

Closes #65

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Proposal: Make output=md the default for the MCP search tool

1 participant