# Journely Markets

> Journely Markets is a freemium MCP server for finance and payments. US, Japan and Vietnam macro data, sector snapshots and stock fundamentals for AI tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://journely.me/api-docs/mcp
- **Repository:** https://github.com/journelyme/journely-mcp
- **MCP Registry name:** io.github.journelyme/journely-markets
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Journely exposes the same data as its REST API through nine MCP tools, with one-to-one parity between the two. The suggested workflow runs top-down: macro indicators, the economic calendar, commodity and yield data, sector overviews, a stock screener, then a single stock's overview, statements, forecasts and price history. A separate tool pulls upcoming earnings dates for a list of US tickers.

Responses carry the unit and reference period of each figure and a data timestamp with a stale flag, and clients receive both text and structured content. Coverage differs by market: US sector data includes aggregates such as P/E and margin, while Japan and Vietnam return sector names with stock counts, and price history is a longer daily series for the US than for Japan and Vietnam.

You need a personal access token, which a free tier provides, sent as a bearer header. The README says outputs are data rather than investment advice and calls the server broker-neutral.

## Features

- **Three-market coverage:** Covers US, Japan and Vietnam macro and stock data.
- **Economic calendar:** Lists events such as FOMC and CPI with previous, consensus and actual values.
- **Stock fundamentals:** Returns statements, ratios, analyst estimates and price targets.
- **Dated, unit-labelled data:** Each row carries its unit and period, and responses flag stale data.
- **REST parity:** Every tool also exists as a REST endpoint with the same data model.
- **Earnings calendar:** Looks up upcoming report dates for a watchlist.

## Good for

- Review a country's inflation outlook alongside rates
- Pull five years of revenue and margins for a Vietnamese company
- Screen a US sector by valuation
- Check this week's central bank events

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http journely-markets https://api.journely.me/api/v1/journely/mcp
```

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

```sh
https://api.journely.me/api/v1/journely/mcp
```

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

```json
{
  "mcpServers": {
    "journely-markets": {
      "url": "https://api.journely.me/api/v1/journely/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "journely-markets": {
      "type": "http",
      "url": "https://api.journely.me/api/v1/journely/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "journely-markets": {
      "serverUrl": "https://api.journely.me/api/v1/journely/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "journely-markets": {
      "type": "http",
      "url": "https://api.journely.me/api/v1/journely/mcp"
    }
  }
}
```

## Tools

- `get_macro_indicators`: Macro indicator panel for a country, with a key view of about 12 headlines.
- `get_macro_forecast`: Forward-looking macro forecasts for a country.
- `get_macro_calendar`: Economic events for US, JP and VN about two weeks ahead.
- `get_market_prices`: Commodity prices, 10-year yields and yield curves.
- `get_sector_overview`: Sector and industry aggregates or sector names by country.
- `screen_stocks`: Lists and ranks stocks or ETFs by sector, industry or theme.
- `get_stock_overview`: Live overview and quote for a ticker.
- `get_stock_statements`: Income statement, balance sheet, cash flow or ratios for a ticker.
- `get_stock_forecast`: Analyst estimates, price targets and rating trend.
- `get_stock_price_history`: Closing-price history for a ticker.
- `get_earnings_calendar`: Upcoming earnings dates for US tickers.

## FAQ

### Is it free?

The README calls it a free-tier server; get a token at journely.me/settings/api-keys.

### How do I authenticate?

Send your personal access token as a bearer Authorization header.

### How many tools are there?

Nine.

### Is it investment advice?

No. The README says outputs are data, not recommendations.

### Is Journely Markets free?

Journely Markets has a free plan, with paid plans for more usage or features.

### How do I add Journely Markets to Claude Code?

Run this command in your terminal: claude mcp add --transport http journely-markets https://api.journely.me/api/v1/journely/mcp

### What are the best alternatives to Journely Markets?

The closest alternatives to Journely Markets are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [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.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/journely-markets
