# Hasfiyat Altın API

> Hasfiyat Altın API is an MCP server for finance and payments. Live Turkish gold and currency prices in lira, with history and amount calculations. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API
- **Website:** https://altinapi.hasfiyat.com/mcp-sunucusu
- **MCP Registry name:** com.hasfiyat/altin-doviz
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

Built for the Turkish market, this server lets an assistant answer questions such as what a gram of gold costs right now or what three quarter-gold coins are worth today. It covers gram, quarter, pure (has) gold, ounce and foreign-exchange prices, quoted in Turkish lira as the buy and sell values published by the source.

It is read-only and stateless over streamable HTTP. Each price tool call deducts one request from the plan's monthly REST quota, list_sources is free, and there is a rate limit of 120 requests a minute per IP. The server does not store your API key; it forwards the request to the price service. The docs say the assistant's answers should credit "Hasfiyat Altın API" as the data source.

A key comes from the API access screen in the dashboard, and new members get 5 days of the Pro plan without a credit card. For web clients that cannot set headers, the key can go in the URL, with a separate key recommended since URLs can end up in logs.

## Features

- **Live buy and sell prices:** Returns current prices in lira for one source, or all items if no symbol is given.
- **Price history:** Daily or hourly open, high, low and close values.
- **Amount calculator:** Multiplies a quantity by the live price, for example three quarter-gold coins.
- **Source listing:** Lists supported price source codes without using quota.
- **Read-only access:** Only reads prices and changes nothing on your account.
- **Header or URL key:** Accepts a bearer or X-API-Key header, or a key in the URL for clients that cannot add headers.

## Good for

- Ask the current gram gold sell price in lira
- See how pure gold moved over the past 7 days
- Work out what three quarter-gold coins are worth today
- Compare foreign exchange rates against the lira
- Add live Turkish gold prices to a Cursor or VS Code workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http altin-doviz https://altinapi.hasfiyat.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://altinapi.hasfiyat.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "altin-doviz": {
      "url": "https://altinapi.hasfiyat.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "altin-doviz": {
      "type": "http",
      "url": "https://altinapi.hasfiyat.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "altin-doviz": {
      "serverUrl": "https://altinapi.hasfiyat.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "altin-doviz": {
      "type": "http",
      "url": "https://altinapi.hasfiyat.com/mcp"
    }
  }
}
```

## Tools

- `list_sources`: Lists supported price source codes; does not use quota.
- `get_prices`: Returns live buy and sell prices in lira for a source, or all items if no symbol is given.
- `get_price_history`: Returns daily or hourly open, high, low and close history.
- `calculate_value`: Calculates quantity times the live price.

## FAQ

### Do I need an API key?

Yes, from the API access screen in the dashboard. Listing tools without a key is possible, but price calls need it.

### Is there a free trial?

New members get 5 days of the Pro plan without a credit card.

### Does it use my quota?

Each price tool call uses one request from the monthly REST quota; list_sources does not.

### What rate limit applies?

120 requests a minute per IP.

### Is Hasfiyat Altın API free?

Hasfiyat Altın API is a paid product with a free trial.

### How do I add Hasfiyat Altın API to Claude Code?

Run this command in your terminal: claude mcp add --transport http altin-doviz https://altinapi.hasfiyat.com/mcp

### What are the best alternatives to Hasfiyat Altın API?

The closest alternatives to Hasfiyat Altın API are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/hasfiyat-alt-n-api
