vaquill-mcp 0.1.0__tar.gz

vaquill_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,39 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

vaquill_mcp-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Byte-compiled
+__pycache__/
+*.py[codz]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+MANIFEST
+
+# Virtual environments
+.venv/
+env/
+venv/
+
+# Testing
+.pytest_cache/
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+
+# Type checkers
+.mypy_cache/
+.pytype/
+.pyre/
+
+# IDE
+.idea/
+.vscode/
+
+# Environment
+.env
+.envrc
+
+# Ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db

vaquill_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vaquill
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

vaquill_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: vaquill-mcp
+Version: 0.1.0
+Summary: MCP server for Vaquill legal research API - search 13M+ Indian court judgments via AI
+Project-URL: Homepage, https://www.vaquill.ai
+Project-URL: Documentation, https://www.vaquill.ai/docs/api-reference
+Project-URL: Repository, https://github.com/vaquill/vaquill-mcp
+Project-URL: Issues, https://github.com/vaquill/vaquill-mcp/issues
+Project-URL: Changelog, https://github.com/vaquill/vaquill-mcp/blob/main/CHANGELOG.md
+Author-email: Vaquill <dev@vaquill.ai>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,india,law,legal,mcp,rag,research,vaquill
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=3.0.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# vaquill-mcp
+
+MCP server for [Vaquill](https://www.vaquill.ai) legal research API. Search 13M+ Indian court judgments, ask AI-powered legal questions, resolve citations, and traverse citation networks — all from your AI tools.
+
+## Quick Start
+
+### Prerequisites
+
+Get your API key from [vaquill.ai/dashboard/api-keys](https://www.vaquill.ai/dashboard/api-keys)
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add vaquill -- uvx vaquill-mcp
+# Then set the env var in your shell: export VAQUILL_API_KEY=vq_key_...
+```
+
+Or add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to Cursor Settings > MCP Servers:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to `.vscode/settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "vaquill": {
+        "command": "uvx",
+        "args": ["vaquill-mcp"],
+        "env": {
+          "VAQUILL_API_KEY": "vq_key_your_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.windsurf/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description | Credits |
+|------|-------------|---------|
+| `ask_legal_question` | AI-powered legal Q&A grounded in court judgments. Standard (fast) or deep (thorough) modes. | 0.5 - 2.0 |
+| `search_legal_cases` | Boolean keyword search with AND/OR/NOT operators. Filter by court, year, country. | 1.0 |
+| `quick_search` | Fast compact search returning top 3-5 results with essentials only. | 0.1 |
+| `resolve_citation` | Resolve any citation format (SCC, AIR, SCR, MANU) to canonical case record. | 0.1 |
+| `search_cases_by_citation` | Search cases by citation text or case name with filters. | 0.1 |
+| `lookup_case` | Full case details with citation treatment stats (followed, overruled, etc.). | 0.1 |
+| `get_citation_network` | Traverse citation graph: which cases cite/are cited by a case. 1-3 hops. | 0.2 |
+| `get_pricing` | Get current API credit pricing (no auth required). | Free |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `VAQUILL_API_KEY` | Yes | - | API key (`vq_key_...`) from dashboard |
+| `VAQUILL_BASE_URL` | No | `https://api.vaquill.ai` | API base URL |
+| `VAQUILL_TIMEOUT` | No | `120` | Request timeout in seconds |
+
+## Example Usage
+
+Once configured, you can ask your AI assistant things like:
+
+- "Search for Supreme Court cases on Section 302 IPC"
+- "What is the legal test for negligence in Indian tort law?"
+- "Resolve the citation AIR 1978 SC 597"
+- "Look up the case Maneka Gandhi vs Union of India and show treatment stats"
+- "Show the citation network around ADM Jabalpur vs Shivkant Shukla"
+- "Compare murder and culpable homicide under IPC" (uses deep mode)
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/vaquill/vaquill-mcp.git
+cd vaquill-mcp
+uv sync --all-extras
+
+# Run locally
+VAQUILL_API_KEY=vq_key_... uv run vaquill-mcp
+
+# Run tests
+uv run pytest
+
+# Test with FastMCP inspector
+uv run fastmcp dev src/vaquill_mcp/server.py
+```
+
+## How It Works
+
+This package is a thin MCP wrapper around the [Vaquill Developer API](https://api.vaquill.ai/external/docs). At startup, it fetches the OpenAPI spec from the live API and auto-generates MCP tools using [FastMCP](https://github.com/jlowin/fastmcp). Tool names and descriptions are customized for optimal LLM performance.
+
+Because the spec is fetched at startup (not bundled), tools automatically reflect any API changes without a package update.
+
+## Credits & Pricing
+
+API calls consume credits. Check current pricing at [vaquill.ai/pricing](https://www.vaquill.ai/pricing) or use the `get_pricing` tool.
+
+1 credit = $0.10 USD = 10 INR
+
+## License
+
+MIT

vaquill_mcp-0.1.0/README.md

@@ -0,0 +1,172 @@
+# vaquill-mcp
+
+MCP server for [Vaquill](https://www.vaquill.ai) legal research API. Search 13M+ Indian court judgments, ask AI-powered legal questions, resolve citations, and traverse citation networks — all from your AI tools.
+
+## Quick Start
+
+### Prerequisites
+
+Get your API key from [vaquill.ai/dashboard/api-keys](https://www.vaquill.ai/dashboard/api-keys)
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add vaquill -- uvx vaquill-mcp
+# Then set the env var in your shell: export VAQUILL_API_KEY=vq_key_...
+```
+
+Or add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to Cursor Settings > MCP Servers:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to `.vscode/settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "vaquill": {
+        "command": "uvx",
+        "args": ["vaquill-mcp"],
+        "env": {
+          "VAQUILL_API_KEY": "vq_key_your_key_here"
+        }
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.windsurf/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "vaquill": {
+      "command": "uvx",
+      "args": ["vaquill-mcp"],
+      "env": {
+        "VAQUILL_API_KEY": "vq_key_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+| Tool | Description | Credits |
+|------|-------------|---------|
+| `ask_legal_question` | AI-powered legal Q&A grounded in court judgments. Standard (fast) or deep (thorough) modes. | 0.5 - 2.0 |
+| `search_legal_cases` | Boolean keyword search with AND/OR/NOT operators. Filter by court, year, country. | 1.0 |
+| `quick_search` | Fast compact search returning top 3-5 results with essentials only. | 0.1 |
+| `resolve_citation` | Resolve any citation format (SCC, AIR, SCR, MANU) to canonical case record. | 0.1 |
+| `search_cases_by_citation` | Search cases by citation text or case name with filters. | 0.1 |
+| `lookup_case` | Full case details with citation treatment stats (followed, overruled, etc.). | 0.1 |
+| `get_citation_network` | Traverse citation graph: which cases cite/are cited by a case. 1-3 hops. | 0.2 |
+| `get_pricing` | Get current API credit pricing (no auth required). | Free |
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `VAQUILL_API_KEY` | Yes | - | API key (`vq_key_...`) from dashboard |
+| `VAQUILL_BASE_URL` | No | `https://api.vaquill.ai` | API base URL |
+| `VAQUILL_TIMEOUT` | No | `120` | Request timeout in seconds |
+
+## Example Usage
+
+Once configured, you can ask your AI assistant things like:
+
+- "Search for Supreme Court cases on Section 302 IPC"
+- "What is the legal test for negligence in Indian tort law?"
+- "Resolve the citation AIR 1978 SC 597"
+- "Look up the case Maneka Gandhi vs Union of India and show treatment stats"
+- "Show the citation network around ADM Jabalpur vs Shivkant Shukla"
+- "Compare murder and culpable homicide under IPC" (uses deep mode)
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/vaquill/vaquill-mcp.git
+cd vaquill-mcp
+uv sync --all-extras
+
+# Run locally
+VAQUILL_API_KEY=vq_key_... uv run vaquill-mcp
+
+# Run tests
+uv run pytest
+
+# Test with FastMCP inspector
+uv run fastmcp dev src/vaquill_mcp/server.py
+```
+
+## How It Works
+
+This package is a thin MCP wrapper around the [Vaquill Developer API](https://api.vaquill.ai/external/docs). At startup, it fetches the OpenAPI spec from the live API and auto-generates MCP tools using [FastMCP](https://github.com/jlowin/fastmcp). Tool names and descriptions are customized for optimal LLM performance.
+
+Because the spec is fetched at startup (not bundled), tools automatically reflect any API changes without a package update.
+
+## Credits & Pricing
+
+API calls consume credits. Check current pricing at [vaquill.ai/pricing](https://www.vaquill.ai/pricing) or use the `get_pricing` tool.
+
+1 credit = $0.10 USD = 10 INR
+
+## License
+
+MIT

vaquill_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "vaquill-mcp"
+dynamic = ["version"]
+description = "MCP server for Vaquill legal research API - search 13M+ Indian court judgments via AI"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Vaquill", email = "dev@vaquill.ai" },
+]
+keywords = ["mcp", "legal", "research", "vaquill", "ai", "rag", "law", "india"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dependencies = [
+    "fastmcp>=3.0.0",
+    "httpx>=0.27.0",
+]
+
+[project.scripts]
+vaquill-mcp = "vaquill_mcp.__main__:main"
+
+[project.urls]
+Homepage = "https://www.vaquill.ai"
+Documentation = "https://www.vaquill.ai/docs/api-reference"
+Repository = "https://github.com/vaquill/vaquill-mcp"
+Issues = "https://github.com/vaquill/vaquill-mcp/issues"
+Changelog = "https://github.com/vaquill/vaquill-mcp/blob/main/CHANGELOG.md"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.24",
+    "respx>=0.22",
+]
+
+[tool.hatch.version]
+path = "src/vaquill_mcp/__init__.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/vaquill_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

vaquill_mcp-0.1.0/src/vaquill_mcp/__init__.py

@@ -0,0 +1,20 @@
+"""Vaquill MCP Server - Legal research tools powered by 13M+ court judgments."""
+
+import logging
+
+__version__ = "0.1.0"
+__all__ = ["__version__", "create_server"]
+
+# PEP 593: Libraries should add NullHandler to prevent "No handler found"
+# warnings. The application (CLI entry point) configures actual handlers.
+logging.getLogger(__name__).addHandler(logging.NullHandler())
+
+
+def create_server():  # noqa: ANN201
+    """Create and configure the Vaquill MCP server.
+
+    Lazy import to avoid loading FastMCP when only ``__version__`` is needed.
+    """
+    from vaquill_mcp.server import create_server as _create_server
+
+    return _create_server()

vaquill_mcp-0.1.0/src/vaquill_mcp/__main__.py

@@ -0,0 +1,13 @@
+"""Entry point for `python -m vaquill_mcp` and `uvx vaquill-mcp`."""
+
+from vaquill_mcp.server import create_server
+
+
+def main() -> None:
+    """Create the Vaquill MCP server and run it on stdio transport."""
+    server = create_server()
+    server.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

vaquill_mcp-0.1.0/src/vaquill_mcp/config.py

@@ -0,0 +1,59 @@
+"""Configuration for the Vaquill MCP server.
+
+Reads settings from environment variables:
+- VAQUILL_API_KEY (required) - Your API key from https://www.vaquill.ai/dashboard/api-keys
+- VAQUILL_BASE_URL (optional) - API base URL, defaults to https://api.vaquill.ai
+- VAQUILL_TIMEOUT (optional) - Request timeout in seconds, defaults to 120
+"""
+
+import os
+
+
+def get_api_key() -> str:
+    """Read API key from environment.
+
+    Raises:
+        ValueError: If VAQUILL_API_KEY is not set or empty.
+    """
+    key = os.environ.get("VAQUILL_API_KEY", "").strip()
+    if not key:
+        raise ValueError(
+            "VAQUILL_API_KEY environment variable is required.\n"
+            "Get your API key at https://www.vaquill.ai/dashboard/api-keys\n\n"
+            "Set it in your MCP client config:\n"
+            '  "env": { "VAQUILL_API_KEY": "vq_key_..." }'
+        )
+    return key
+
+
+def get_base_url() -> str:
+    """Read base URL from environment or use production default.
+
+    Raises:
+        ValueError: If the URL scheme is not http or https.
+    """
+    url = os.environ.get("VAQUILL_BASE_URL", "https://api.vaquill.ai").rstrip("/")
+    if not url.startswith(("http://", "https://")):
+        raise ValueError(
+            f"VAQUILL_BASE_URL must start with http:// or https://, got: {url!r}"
+        )
+    return url
+
+
+def get_timeout() -> float:
+    """Read timeout from environment or use default.
+
+    Default is 120 seconds -- the /ask endpoint in deep mode can take
+    up to 90 seconds (RAG retrieval + LLM planning + generation + refinement).
+
+    Raises:
+        ValueError: If the timeout is not a positive number.
+    """
+    raw = os.environ.get("VAQUILL_TIMEOUT", "120")
+    try:
+        timeout = float(raw)
+    except ValueError:
+        raise ValueError(f"VAQUILL_TIMEOUT must be a number, got: {raw!r}") from None
+    if timeout <= 0:
+        raise ValueError(f"VAQUILL_TIMEOUT must be positive, got: {timeout}")
+    return timeout

vaquill_mcp-0.1.0/src/vaquill_mcp/descriptions.py

@@ -0,0 +1,63 @@
+"""LLM-optimized tool descriptions for Vaquill MCP tools.
+
+Each description tells the LLM WHEN to use the tool, WHAT it returns,
+and the credit cost. Kept concise (50-100 words) for efficient context usage.
+
+These override the verbose OpenAPI descriptions which contain multi-paragraph
+markdown with tables, code examples, and SSE documentation — far too long
+for an LLM tool description.
+"""
+
+TOOL_DESCRIPTIONS: dict[str, str] = {
+    "ask_legal_question": (
+        "Ask a legal question and get an AI-generated answer grounded in 13M+ Indian "
+        "court judgments. Use 'standard' mode (fast, 0.5 credits) for factual questions "
+        "or 'deep' mode (thorough multi-hop analysis, 2.0 credits) for complex comparisons. "
+        "Pass chatHistory for follow-up questions. Returns answer text with numbered source "
+        "citations including case name, court, year, relevance score, excerpt, and PDF link."
+    ),
+    "search_legal_cases": (
+        "Search the legal corpus using boolean keyword queries. Supports AND, OR, NOT "
+        "operators and quoted phrases (e.g., '\"beyond reasonable doubt\" AND murder'). "
+        "Filter by court type, court name, year range, and country code. Returns paginated "
+        "results with content text, citation, court, relevance score, highlighted snippet, "
+        "and PDF URL. Cost: 1 credit per search."
+    ),
+    "quick_search": (
+        "Fast compact legal search returning top 3-5 results with just the essentials: "
+        "title, citation, court, year, summary excerpt, and PDF link. Same boolean query "
+        "syntax as search_legal_cases but returns fewer, flatter results. Best when you "
+        "need a quick overview rather than detailed results. Cost: 0.1 credits."
+    ),
+    "resolve_citation": (
+        "Resolve any Indian legal citation format to its canonical case record. Accepts "
+        "SCC, AIR, SCR, MANU, SCALE, INSC formats (e.g., '(2019) 11 SCC 706' or "
+        "'AIR 1976 SC 1207'). Returns case details and all known citation aliases/formats. "
+        "Returns found=false (not an error) when citation cannot be resolved. Cost: 0.1 credits."
+    ),
+    "search_cases_by_citation": (
+        "Search for legal cases by citation text or case name. Use when you know part of "
+        "a case name (e.g., 'Maneka Gandhi') or a partial citation. Filter by court code "
+        "(SC, DEL, BOM, MAD, etc.), year range, and validity status (GOOD_LAW, OVERRULED, "
+        "DISTINGUISHED, etc.). Returns up to 50 matching cases with metadata. Cost: 0.1 credits."
+    ),
+    "lookup_case": (
+        "Get full details for a specific case by its citation. Returns comprehensive case "
+        "metadata, all known citation aliases, and citation treatment statistics showing "
+        "how many times the case was followed, distinguished, overruled, approved, or "
+        "referred. Use after resolve_citation or search_cases_by_citation for deep case "
+        "analysis. Cost: 0.1 credits."
+    ),
+    "get_citation_network": (
+        "Traverse the citation network around a case. Returns nodes (cases) and edges "
+        "(citing relationships) with treatment types (followed, distinguished, overruled). "
+        "Specify direction: 'outbound' (cases this cites), 'inbound' (cases citing this), "
+        "or 'both'. Set depth (1-3 hops) and limit (1-100 nodes). Useful for understanding "
+        "a case's legal influence. Cost: 0.2 credits."
+    ),
+    "get_pricing": (
+        "Get current API credit pricing. Returns per-endpoint credit costs and "
+        "credit-to-currency conversion rates (1 credit = $0.10 USD = 10 INR). "
+        "No authentication required. Use to check costs before making API calls."
+    ),
+}