smallcase-mcp

⚠️ UNOFFICIAL — this is NOT the official smallcase MCP

This is an independent, community-built project. It is NOT built, authorized, endorsed, sponsored, or supported by smallcase, it is NOT "the smallcase MCP," and it uses no official smallcase API. "smallcase" is a trademark of its respective owner. It reads smallcase's public website endpoints (not the official smallcase Gateway API), which can change or break at any time. Provided for informational/research use only — not investment advice, and not an official data source. Some data (notably past returns) is shown in smallcase's own UI behind a consent step ("as per applicable guidelines"); use at your own discretion. All data © smallcase and the respective publishers.

A read-only MCP server that exposes smallcase's public discovery data — the catalog of published smallcases, their returns, risk metrics, rationale, rebalance schedule, plus stocks, mutual funds and curated collections — to any LLM or agent (Claude Desktop, Claude Code, Cursor, …).

No API key. No browser. No login. Just clean HTTP over the endpoints the public smallcase.com website already calls for logged-out visitors.

What it can and can't do

✅ Available (public) ❌ Not available (gated by smallcase)
Search/list the full catalog of published smallcases Constituents / holdings + weights
CAGR, returns (1D → 5Y, since inception) Rebalance constituent history
Risk metrics (volatility, sharpe, beta, cap split, 52w hi/lo) Your personal portfolio / investments
Minimum investment, monthly subscription price Placing orders / any transaction
Rationale, rebalance schedule, publisher info

Tools

Tool Description
search_smallcases(query, volatility, min_amount, max_amount, sort, limit, include_private) Search/screen published smallcases. Text match on name/description/publisher, volatility = low/medium/high, min/max investment, sort = popularity | min_amount | returns | recently_rebalanced. include_private=true also surfaces schemes closed to new investors (marked private), which smallcase hides from public discovery.
get_smallcase(scid) Full detail for one smallcase by SCID (e.g. SCET_0005): returns, risk, rationale, methodology, and flags (active / blocked / private). Works for private schemes too if you know the SCID.
compare_smallcases(scids) Side-by-side of 2–5 smallcases (returns / risk / min investment).
get_rebalance_schedule(scid) Rebalance cadence and last/next rebalance dates for a smallcase.
list_managers(page, page_size) List smallcase publishers / research houses.
search_stocks(query, limit) Search stocks in smallcase's public universe (name / ticker / sector).
search_mutual_funds(query, limit) Search mutual funds (name / AMC / category).
list_collections(query, limit) List curated smallcase collections (themed groupings).

Example prompts once connected: "find low-volatility gold smallcases under ₹5000", "compare SCET_0005 and the top smallcase by returns", "what's the rationale behind SCET_0005?", "when does SCET_0005 next rebalance?", "search bank stocks", "show me energy mutual funds".

Install

The package is on PyPI — no clone, no path, no API key. Any MCP client can launch it with uvx.

Claude Code (one-liner)

claude mcp add -s user smallcase -- uvx smallcase-mcp@latest

Claude Desktop

{
  "mcpServers": {
    "smallcase": {
      "command": "uvx",
      "args": ["smallcase-mcp@latest"]
    }
  }
}

Any other MCP client

Point it at the stdio command:

uvx smallcase-mcp

@latest makes uvx resolve the newest release instead of reusing a cached one.

Development

Only needed if you want to hack on the server itself:

git clone https://github.com/Pragadeesh122/smallcase-mcp.git
cd smallcase-mcp
uv sync
uv run python tests/test_live.py          # live-API checks
uv run python tests/test_mcp_protocol.py  # full MCP handshake over stdio

To run your local checkout as the server instead of the PyPI build:

claude mcp add -s user smallcase -- uv --directory /path/to/smallcase-mcp run smallcase-mcp

Stack

Python 3.11+ · MCP Python SDK (FastMCP) · httpx.

License

MIT. Not affiliated with smallcase. See the notice at the top of this file and in the LICENSE.

Project links

Data verified by PyPI on Aug 11, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Pragadeesh from gravatar.com Pragadeesh

Credits

Author: Pragadeesh122

GitHub Statistics

Data verified by PyPI on Aug 11, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.11

Tags

agent india investing llm mcp smallcase unofficial

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

smallcase_mcp-0.2.1.tar.gz (56.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

smallcase_mcp-0.2.1-py3-none-any.whl (12.3 kB view details)

Uploaded Python 3

File details

Details for the file smallcase_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: smallcase_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 56.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for smallcase_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 137c7216fae2c1c9a6fffb68dc435dd32211c8e7190c52710e874615f27f5834
MD5 e1950590dde8fdeb50d7886b0f8e4fc2
BLAKE2b-256 177d2738c48fe372c2b7577c43cef09d7cf0909ad0c5f17f206ebfb7c4e39047

See more details on using hashes here.

Provenance

The following attestation bundles were made for smallcase_mcp-0.2.1.tar.gz:

Publisher: publish.yml on Pragadeesh122/smallcase-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file smallcase_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: smallcase_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 12.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for smallcase_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2c94633d54234549a0342a9017ef4593a0daf1b7cf652d63836b3ecb725d9905
MD5 a984c5caf5610d18874cc954efb76bdc
BLAKE2b-256 c58762f41bcde7e74b222d63b367762284ba303e2f188211daeac01c52de6670

See more details on using hashes here.

Provenance

The following attestation bundles were made for smallcase_mcp-0.2.1-py3-none-any.whl:

Publisher: publish.yml on Pragadeesh122/smallcase-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page