Positive Search MCP server

Infrastructure for trading AI agents and their humans

which allows saving tokens while getting the highest-quality information about the current news background. Through the analysis of a large number of open sources, Polymarket, X and Truth.

An advanced scoring formula, a system of narratives and a source-quality audit together help not to let fakes through. And to easily make decisions based on information that is already analyzed, selected and sorted. The process of collecting the information and the process of analysis are laid out, described and easy to understand — and assembled from open sources, so, just in case, all of it is very easy to verify.

For the human on the site — a convenient UX where you immediately see which narratives pull the price and in which direction. It provides history in the blockchain, which gives very high reliability. The only tool to see the movement — sentiment over the last day, over the last few days, over the last week, which also helps to make better decisions in trading.

Want the details? How the AI reads the news and builds the index — About, in eight languages: EN · RU · DE · FR · ES · PT · PL · NL

Install

Python 3.9+. No dependencies — standard library only, so there is no version conflict to resolve and nothing to keep updated.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "positive-search": {
      "command": "uvx",
      "args": ["positive-search-mcp"]
    }
  }
}

Claude Code

claude mcp add positive-search -- uvx positive-search-mcp

Cursor

~/.cursor/mcp.json — same shape as the Claude Desktop block above.

Restart the client afterwards, then ask it "what's the news sentiment on bitcoin right now?"

Without uv

Any of these work just as well — it is one file with no imports beyond the standard library:

pipx install positive-search-mcp        # or: pip install positive-search-mcp
positive-search-mcp --selftest          # verify it talks to the site

git clone https://github.com/IliaKostroma/positive-search-mcp.git
python3 positive-search-mcp/ps_mcp.py --selftest

In the last case point command at python3 and args at the absolute path to ps_mcp.py.

--selftest runs the handshake and every tool against the live site and prints a pass/fail line for each — worth running once before you trust it.

Tools

Assets: BTC, GOLD, OIL. Loose spellings work too — bitcoin, XAU, crude oil.

What makes it worth citing

Every reading carries its own measurement time. The three assets are scored on their own hourly runs, so their readings carry three different timestamps. Quote a number with the time next to it — a sentiment value without its moment is wrong the hour after.

The number is a stored fact, not a live recomputation. It is computed once, when the run happens, from the components captured in that same run. Re-read that run tomorrow and you get the same number to the last digit.

Every source is linked. The index is only as good as what it read, so what it read is public: get_sources returns each headline with its own score and a link to the original.

Past readings cannot be silently rewritten. Every run enters a sha256 hash chain whose head is anchored daily in the Bitcoin blockchain via OpenTimestamps. The fingerprints and their proofs are published at https://positivesearch.app/proofs/ and verify independently of this site and its owner (ots verify).

Honest limits, stated up front. It measures the tone of news coverage. It is not price, not a price forecast, and not financial advice. We do not recommend using it as your only input — use it alongside technical, fundamental and other analysis, as one instrument among several.

How to read the number

+1 strongly bullish coverage, −1 strongly bearish, 0 balanced, not silent — bull and bear pressure are measured separately, so a reading near zero usually means two strong narratives pulling against each other. get_narratives tells the two cases apart.

"Bullish" means works in favour of the price, not good news. Bad news for an industry is often bullish for its price.

Without MCP

Everything here is also plain HTTP, no key required:

• Machine entry point: https://positivesearch.app/.well-known/agents-gate.json

• Methodology and limits: https://positivesearch.app/llms.txt

• Human pages: Bitcoin · Gold · Oil

Contact

Need another instrument (ETH, SOL, an FX pair, an index)? The engine is not tied to any asset — hi@positivesearch.app.

MIT licence for this client. The readings themselves are published under CC BY 4.0.