# Send Mfapi to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "mfapi",
    "name": "Mfapi",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kanaksinghal/mfapi",
    "canonicalUrl": "https://clawhub.ai/kanaksinghal/mfapi",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/mfapi",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mfapi",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/get_nav.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "mfapi",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T14:23:31.351Z",
      "expiresAt": "2026-05-12T14:23:31.351Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mfapi",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=mfapi",
        "contentDisposition": "attachment; filename=\"mfapi-0.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "mfapi"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/mfapi"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/mfapi",
    "downloadUrl": "https://openagent3.xyz/downloads/mfapi",
    "agentUrl": "https://openagent3.xyz/skills/mfapi/agent",
    "manifestUrl": "https://openagent3.xyz/skills/mfapi/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/mfapi/agent.md"
  }
}
```
## Documentation

### MFapi Skill

Query Indian mutual fund data — NAV history, scheme info, search — using the free MFapi.in API.

### Setup

No authentication or API keys required. The API is completely free and open.

Ensure curl and jq are installed:

# Debian/Ubuntu
sudo apt install -y curl jq

# macOS
brew install curl jq

### What is an ISIN Code?

ISIN (International Securities Identification Number) is a 12-character alphanumeric code that uniquely identifies a security globally (e.g. INF200K01UT4). Indian mutual fund schemes have up to two ISINs:

isinGrowth — identifies the Growth option of the scheme
isinDivReinvestment — identifies the IDCW (Dividend) Reinvestment option (may be null)

ISIN codes are printed on CAS (Consolidated Account Statements), broker/demat platforms, and AMFI's website. They are stable identifiers — unlike scheme names, they don't change when a fund house rebrands.

### Base URL

https://api.mfapi.in

Data is updated 6× daily (10:05 AM, 2:05 PM, 6:05 PM, 9:05 PM, 3:09 AM, 5:05 AM IST).

### Search schemes by name

curl -s "https://api.mfapi.in/mf/search?q=HDFC" | jq '.[] | {schemeCode, schemeName}'

### List all schemes (paginated)

curl -s "https://api.mfapi.in/mf?limit=100&offset=0" | jq '.[] | {schemeCode, schemeName}'

### Get latest NAV for a scheme

curl -s "https://api.mfapi.in/mf/125497/latest" | jq '{scheme: .meta.scheme_name, nav: .data[0].nav, date: .data[0].date}'

### Get NAV history for a scheme

curl -s "https://api.mfapi.in/mf/125497" | jq '{scheme: .meta.scheme_name, records: (.data | length)}'

### Get NAV history with date range

curl -s "https://api.mfapi.in/mf/125497?startDate=2023-01-01&endDate=2023-12-31" | jq '.data'

### Get latest NAV for all schemes

curl -s "https://api.mfapi.in/mf/latest" | jq '.[:5]'

### Latest NAV (/mf/{scheme_code}/latest)

{
  "meta": {
    "fund_house": "HDFC Mutual Fund",
    "scheme_type": "Open Ended Schemes",
    "scheme_category": "Equity Scheme - Large Cap Fund",
    "scheme_code": 125497,
    "scheme_name": "HDFC Top 100 Fund - Direct Plan - Growth",
    "isin_growth": "INF179K01BB2",
    "isin_div_reinvestment": null
  },
  "data": [
    {
      "date": "26-10-2024",
      "nav": "892.45600"
    }
  ],
  "status": "SUCCESS"
}

### Search (/mf/search?q=...)

[
  {
    "schemeCode": 125497,
    "schemeName": "HDFC Top 100 Fund - Direct Plan - Growth"
  }
]

### Scheme list (/mf)

[
  {
    "schemeCode": 125497,
    "schemeName": "HDFC Top 100 Fund - Direct Plan - Growth",
    "isinGrowth": "INF179K01BB2",
    "isinDivReinvestment": "INF179K01BC0"
  }
]

### Endpoints Reference

MethodEndpointDescriptionParametersGET/mf/searchSearch schemes by nameq (required)GET/mfList all schemes (paginated)limit (1–1000), offset (default 0)GET/mf/{scheme_code}NAV history for a schemestartDate, endDate (ISO 8601)GET/mf/{scheme_code}/latestLatest NAV for a scheme—GET/mf/latestLatest NAV for all schemes—

### Get Latest NAV by ISIN (Python)

The API doesn't support querying by ISIN directly. The scripts/get_nav.py script resolves ISIN → scheme code using a locally cached scheme list, then fetches the latest NAV.

### How it works

Cache — Downloads the full scheme list (/mf, ~37k schemes) to /tmp/mfapi-schemes.json. Refreshes automatically if the cache is missing or older than 24 hours.
Lookup — Searches isinGrowth and isinDivReinvestment fields in the cache. If no match, refreshes the cache and retries.
Fetch — Uses the resolved scheme code to call /mf/{scheme_code}/latest.

### Usage

# Single ISIN
python3 scripts/get_nav.py INF200K01UT4

# Multiple ISINs
python3 scripts/get_nav.py INF200K01UT4 INF846K01DP8

### Example output

{
  "isin": "INF200K01UT4",
  "scheme_code": 119800,
  "scheme_name": "SBI Liquid Fund - DIRECT PLAN -Growth",
  "fund_house": "SBI Mutual Fund",
  "category": "Debt Scheme - Liquid Fund",
  "nav": "4277.67540",
  "date": "18-02-2026"
}

When multiple ISINs are passed, the output is a JSON array.

### Notes

Dates in responses use DD-MM-YYYY format; query params use ISO 8601 (YYYY-MM-DD)
NAV values are strings with 5-decimal precision
Scheme codes can be found via the search or list endpoints, or from AMFI's website
The /mf endpoint returns all ~37,000 schemes; the Python script caches it locally at /tmp/mfapi-schemes.json to avoid repeated large fetches
Cache auto-refreshes on ISIN lookup miss or after 24 hours
No rate-limit headers are published, but the API asks for fair usage

### Examples

# Find all SBI mutual fund schemes
curl -s "https://api.mfapi.in/mf/search?q=SBI" | jq '.[].schemeName'

# Get today's NAV for a known scheme
curl -s "https://api.mfapi.in/mf/119551/latest" | jq '.data[0]'

# Compare NAVs across a year
curl -s "https://api.mfapi.in/mf/125497?startDate=2025-01-01&endDate=2025-12-31" \\
  | jq '[.data[0], .data[-1]] | {latest: .[0], oldest: .[1]}'

# Get fund house and category for a scheme
curl -s "https://api.mfapi.in/mf/125497/latest" | jq '.meta | {fund_house, scheme_category}'

# List first 10 Direct Plan Growth schemes matching "Axis"
curl -s "https://api.mfapi.in/mf/search?q=Axis" \\
  | jq '[.[] | select(.schemeName | test("Direct.*Growth"))] | .[:10]'

# Get latest NAV by ISIN
python3 scripts/get_nav.py INF200K01UT4
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kanaksinghal
- Version: 0.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T14:23:31.351Z
- Expires at: 2026-05-12T14:23:31.351Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/mfapi)
- [Send to Agent page](https://openagent3.xyz/skills/mfapi/agent)
- [JSON manifest](https://openagent3.xyz/skills/mfapi/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/mfapi/agent.md)
- [Download page](https://openagent3.xyz/downloads/mfapi)