mfapi for Openclaw

A powerful tool to query Indian mutual fund NAV data, historical performance, and scheme information through the free MFapi.in REST API.

kanaksinghal
v0.1.0
Mar 1, 2026
0
831
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install mfapi

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install mfapi using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is mfapi?

The mfapi skill enables AI agents to interact with the Indian mutual fund ecosystem by fetching real-time and historical financial data. It leverages the open-access MFapi.in REST API to retrieve Net Asset Values (NAV), scheme categories, and fund house details without requiring API keys or complex authentication. This makes it an essential component for developers building Openclaw Skills focused on financial monitoring, portfolio tracking, or investment analysis.

By providing a bridge between global ISIN codes and internal scheme identifiers, the skill ensures high data integrity for automated workflows. Whether you are tracking a specific Growth plan or analyzing Dividend Reinvestment options, this skill provides the programmatic access needed to automate Indian financial data retrieval efficiently.

mfapi Use Cases

  • Tracking daily Net Asset Value (NAV) updates for Indian mutual fund portfolios.
  • Analyzing historical fund performance over specific date ranges for trend analysis.
  • Searching and identifying mutual fund schemes using partial names or unique ISIN codes.
  • Automating financial reports and data visualization for wealth management applications.
  • Resolving global ISIN identifiers to specific API scheme codes for database consistency.

How mfapi Works

  1. The skill interfaces with the MFapi.in REST API using curl and jq to fetch scheme metadata or NAV values.
  2. Users can search for specific funds by name, which returns a list of unique scheme codes and fund identifiers.
  3. For precise identification, a Python-based lookup mechanism maps ISIN codes to scheme IDs using a locally cached JSON database.
  4. NAV data is retrieved in a structured JSON format, including comprehensive metadata like fund house name and scheme category.
  5. Historical data requests process date ranges using ISO 8601 parameters to provide a time-series of fund performance.

mfapi Setup

To utilize these Openclaw Skills, ensure that curl and jq are available on your system. No API keys or registration are required for the underlying service.

# Install dependencies on Debian/Ubuntu
sudo apt install -y curl jq

# Install dependencies on macOS
brew install curl jq

If you intend to use the ISIN-to-NAV resolution feature, ensure Python 3 is installed to execute the included caching and lookup scripts.

mfapi Data Schema & Taxonomy

The skill organizes data through two primary structures: Metadata and NAV Data. The metadata provides classification details, while the data array contains time-stamped values.

Field Type Description
schemeCode Integer The unique internal identifier for a mutual fund scheme
isinGrowth String The International Securities Identification Number for the Growth option
nav String The Net Asset Value represented as a string with 5-decimal precision
date String The date of the NAV entry in DD-MM-YYYY format
fund_house String The name of the Asset Management Company (AMC)

Local caching of the complete scheme list is managed at /tmp/mfapi-schemes.json to optimize performance across the dataset of ~37,000 schemes.

mfapi Advanced Features

  • Intelligent Caching: Automatically downloads and caches the full scheme list to minimize API load and accelerate lookups.
  • ISIN-to-Scheme Mapping: Seamlessly maps stable ISIN identifiers to dynamic API scheme codes using a Python-based resolution layer.
  • Automated Cache Invalidation: The local data cache auto-refreshes every 24 hours or upon a lookup miss to ensure high data accuracy.
  • ISO Date Filtering: Supports standard ISO 8601 date parameters for precise historical data extraction and time-series analysis.
  • Multi-Scheme Support: Capability to process multiple ISINs in a single command for batch portfolio updates within Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*