Journely Markets MCP server

Journely MCP Server Free MCP server for Vietnamese, Japanese, and US market data. 9 tools · REST + MCP parity · OpenAPI 3.1 documented · broker-neutral · live data

⚠️ Not investment advice. This server returns market data for research and AI-agent use. Outputs are data, not recommendations. You are responsible for verifying any analysis and for compliance with the rules of the markets and jurisdictions you operate in.

What it is

Journely operates a public, free-tier MCP server (Model Context Protocol, spec 2025-06-18) that gives AI agents structured access to Vietnamese, Japanese, and US market data — macro indicators and forecasts, an economic calendar, sector aggregates, and per-stock fundamentals, analyst estimates and price history.

Every MCP tool is also a REST endpoint with the same data model. So you can:

• Wire it into Claude Desktop, Cursor, or any MCP-capable client → ask natural-language questions
• Call it directly from any HTTP client → drop into your own AI pipeline, notebook, or app

This repository is the public-facing landing for the server. The MCP server itself runs at https://api.journely.me/api/v1/journely/mcp — there's nothing to install or self-host.

Why it exists

In 2026, every "Top MCP servers for financial data" roundup covers the same US-first providers (EODHD, Finnhub, Financial Modeling Prep, Alpha Vantage, MarketXLS, Financial Datasets). Vietnamese market coverage is thin or paid-only; broker-tied servers exist but lock you to one execution venue. Journely is broker-neutral, multi-market, and free at the tier most indie and research workloads need.

Quick start

Option 1 — Claude Desktop (MCP)

Add the server to ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "journely": {
      "url": "https://api.journely.me/api/v1/journely/mcp",
      "headers": {
        "Authorization": "Bearer jrn_live_YOUR_TOKEN"
      }
    }
  }
}

Get a free token at https://journely.me/settings/api-keys. Restart Claude Desktop. All 9 tools will appear and Claude can call them automatically.

Try a prompt:

"Pull VIC's last 5 years of revenue and margins, then check where Vietnamese inflation and rates are heading."

Option 2 — cURL (REST)

export JOURNELY_TOKEN="your-token-here"

# Vietnam macro indicators
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/macro/indicators?country=VN"

# VIC (Vingroup) snapshot + quote
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/stocks/VIC/overview?country=VN"

# VIC income statement (annual)
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/stocks/VIC/statements?country=VN&type=income"

Option 3 — Python (or any HTTP client)

import httpx

client = httpx.Client(
    base_url="https://api.journely.me/api/v1/journely",
    headers={"Authorization": f"Bearer {TOKEN}"},
)

# Sector snapshot (broad-market, not country-split): P/E, margin, 1Y change
r = client.get("/data/sectors", params={"level": "sector"})
print(r.json())

Tools

All 9 tools are exposed via both MCP and REST. One-to-one parity, same data model.

Shortened. The full README is on GitHub.