maha-sdk

Zero-dependency Python client for the Maha Strategies API, with native tool adapters for LangChain and CrewAI.

pip install maha-sdk

Client

from maha_sdk import MahaClient

client = MahaClient(api_key="maha_live_sk_...")

client.balance()
client.compress(task="brief the board", documents=[{"id": "d1", "text": "..."}], token_budget=4000)
client.verify_claim("chronobiological-entrainment")
client.call_mcp_tool("mcp_srv_...", "tools/calculateRiskScore", {"portfolioId": "pf_1"})

Errors are typed, so an agent can act on them rather than parse strings:

from maha_sdk import MahaAuthenticationError, MahaCreditError

try:
    client.compress(...)
except MahaCreditError as error:
    print(f"Out of credits. Top up at {error.purchase_url}")
except MahaAuthenticationError:
    print("The API key is invalid or revoked.")

LangChain

pip install 'maha-sdk[langchain]'

from langgraph.prebuilt import create_react_agent
from maha_sdk import MahaClient
from maha_sdk.langchain import MahaToolkit

tools = MahaToolkit(MahaClient(api_key="maha_live_sk_...")).get_tools()
agent = create_react_agent(llm, tools)

CrewAI

pip install 'maha-sdk[crewai]'

from crewai import Agent
from maha_sdk import MahaClient
from maha_sdk.crewai import maha_tools

researcher = Agent(
    role="Researcher",
    goal="Ground every claim in a cited source",
    tools=maha_tools(MahaClient(api_key="maha_live_sk_...")),
)

Tools

maha_verify_claim returns the claim's status alongside its summary, and says plainly when a record is not evidence-backed. The status label is material: VERIFIED and SOURCED identify evidence status, while ILLUSTRATIVE and UNVERIFIED must not be treated as established fact. An agent that cannot see the label will present the latter as though it were the former.

Design notes

No runtime dependencies. This installs into agent environments that already pin their own HTTP stack, so it must not force a resolution against it, and it cannot carry a transitive vulnerability into someone else's agent. Framework packages are optional extras.

Payment is never autonomous. A depleted key raises MahaCreditError with a purchase URL. Buying credits requires a human to authorize the payment; no method here can charge anyone.