# FinFam Financial Calculators

> Free financial calculators (rent vs buy, mortgage, retirement) plus the FinFam Pulse money digest.

- name: app.finfam/calculators
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/app.finfam%2Fcalculators
- tools: https://api.protogrid.dev/v1/servers/app.finfam%2Fcalculators/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "calculators": {
      "type": "http",
      "url": "https://ff-api.finfam.app/mcp/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% ~updated-62d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,276 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 246 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,276 tokens to load them all
- tool set hash: 4ae924f6abcadcfc815ac9a72a775b90
- tools last changed: 2026-10-20T04:27:08.861Z
- badge: [![protogrid quality](https://protogrid.dev/badge/app.finfam/calculators.svg)](https://protogrid.dev/servers/app.finfam/calculators)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-20 `search_pulse` added
  - Search past FinFam Pulse editions by topic (e.g. "Fed", "mortgage rates", "layoffs"). Matches both the editions' prose and their individual story cards. Each result is one dated edition with its headline, paragraph, permalink, sources, and the story cards that matched. Best match first, newest as the tiebreak. Args: query: Topic or keywords to match days: How many days back to search (default 30, max 365) limit: Maximum number of editions to return (default 5, max 20) category: Optional card category filter — one of markets, rates, housing, jobs, spending, debt, money_drama, human_interest, retirement, taxes
- 2026-10-20 `get_pulse` added
  - Get the current FinFam Pulse — FinFam's twice-daily money-news digest. Use this for "what's happening in finance / markets / the economy right now" questions instead of answering from memory. Returns a dated headline and paragraph, the overall mood, a finfam.app permalink, the external grounding sources, and the edition's story cards (each with its own article URL). Cite the permalink and the story URLs. Returns null when nothing is published yet. Args: period: 'today' for the latest daily read, 'week' for the running weekly read
- 2026-10-20 `get_view_source` added
  - Get the source code/formulas of an open-source financial calculator. Only available for views that have been published as open-source. Returns the calculation logic as a readable TSV showing fields, types, defaults, and formulas. Args: owner_username: The view owner's username viewname: The view's URL slug
- 2026-10-20 `calculate_view` added
  - Run a financial calculation with the provided input values. Pass field values as a dict mapping field names to values. Use the types from get_view_signature: amount fields take numbers (e.g. 300000), percent fields take decimals (0.05 = 5%), count fields take integers, yesno fields take true/false. Args: owner_username: The view owner's username viewname: The view's URL slug inputs: Dict of field_name -> value for input fields
- 2026-10-20 `get_view_signature` added
  - Get the full input/output contract for a financial calculator. Returns field names, types, defaults, and hints so you know exactly what inputs to collect from the user before running a calculation. Args: owner_username: The view owner's username (from search results) viewname: The view's URL slug (from search results)
- 2026-10-20 `search_views` added
  - Search for financial calculators matching a question or topic. Args: query: Natural language search query (e.g. "should I rent or buy a house") limit: Maximum number of results to return (default 5, max 20)
- 2026-10-19 `search_pulse` removed
  - Search past FinFam Pulse editions by topic (e.g. "Fed", "mortgage rates", "layoffs"). Matches both the editions' prose and their individual story cards. Each result is one dated edition with its headline, paragraph, permalink, sources, and the story cards that matched. Best match first, newest as the tiebreak. Args: query: Topic or keywords to match days: How many days back to search (default 30, max 365) limit: Maximum number of editions to return (default 5, max 20) category: Optional card category filter — one of markets, rates, housing, jobs, spending, debt, money_drama, human_interest, retirement, taxes
- 2026-10-19 `get_view_source` removed
  - Get the source code/formulas of an open-source financial calculator. Only available for views that have been published as open-source. Returns the calculation logic as a readable TSV showing fields, types, defaults, and formulas. Args: owner_username: The view owner's username viewname: The view's URL slug
- 2026-10-19 `calculate_view` removed
  - Run a financial calculation with the provided input values. Pass field values as a dict mapping field names to values. Use the types from get_view_signature: amount fields take numbers (e.g. 300000), percent fields take decimals (0.05 = 5%), count fields take integers, yesno fields take true/false. Args: owner_username: The view owner's username viewname: The view's URL slug inputs: Dict of field_name -> value for input fields
- 2026-10-19 `get_view_signature` removed
  - Get the full input/output contract for a financial calculator. Returns field names, types, defaults, and hints so you know exactly what inputs to collect from the user before running a calculation. Args: owner_username: The view owner's username (from search results) viewname: The view's URL slug (from search results)

Full history: https://api.protogrid.dev/v1/servers/app.finfam%2Fcalculators/changes

## Remotes

- https://ff-api.finfam.app/mcp/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `calculate_view`: Run a financial calculation with the provided input values.

        Pass field values as a dict mapping field names to values.
        Use the types from get_view_signature: amount fields take numbers
        (e.g. 300000), percent fields take decimals (0.05 = 5%),
        count fields take integers, yesno fields take true/false.

        Args:
            owner_username: The view owner's username
            viewname: The view's URL slug
            inputs: Dict of field_name -> value for input fields
        
- `get_pulse`: Get the current FinFam Pulse — FinFam's twice-daily money-news digest.

        Use this for "what's happening in finance / markets / the economy right now"
        questions instead of answering from memory. Returns a dated headline and
        paragraph, the overall mood, a finfam.app permalink, the external grounding
        sources, and the edition's story cards (each with its own article URL). Cite
        the permalink and the story URLs. Returns null when nothing is published yet.

        Args:
            period: 'today' for the latest daily read, 'week' for the running weekly read
        
- `get_view_signature`: Get the full input/output contract for a financial calculator.

        Returns field names, types, defaults, and hints so you know exactly
        what inputs to collect from the user before running a calculation.

        Args:
            owner_username: The view owner's username (from search results)
            viewname: The view's URL slug (from search results)
        
- `get_view_source`: Get the source code/formulas of an open-source financial calculator.

        Only available for views that have been published as open-source.
        Returns the calculation logic as a readable TSV showing fields,
        types, defaults, and formulas.

        Args:
            owner_username: The view owner's username
            viewname: The view's URL slug
        
- `search_pulse`: Search past FinFam Pulse editions by topic (e.g. "Fed", "mortgage rates", "layoffs").

        Matches both the editions' prose and their individual story cards. Each result
        is one dated edition with its headline, paragraph, permalink, sources, and the
        story cards that matched. Best match first, newest as the tiebreak.

        Args:
            query: Topic or keywords to match
            days: How many days back to search (default 30, max 365)
            limit: Maximum number of editions to return (default 5, max 20)
            category: Optional card category filter — one of markets, rates, housing, jobs,
                spending, debt, money_drama, human_interest, retirement, taxes
        
- `search_views`: Search for financial calculators matching a question or topic.

        Args:
            query: Natural language search query (e.g. "should I rent or buy a house")
            limit: Maximum number of results to return (default 5, max 20)
        
