Macroeconomic releases, release calendars, and FX spot rates from official sources.

MITAuto-check passed

Install Fxmacrodata

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill fxmacrodata -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors fxmacrodata --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/fxmacrodata .claude/skills/fxmacrodata && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fxmacrodata
GitHub stars
1.3k
Token cost
~1.1k tokens
SKILL.md length
462 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Macroeconomic releases, release calendars, and FX spot rates from official sources.

  • Works in 6 steps: This connector is read-only: every call… → When freemium_delay.withheld_count is… → When freemium_window is present, the… → …
  • Phrases: fxmacrodata
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder; needs FXMACRODATA_API_KEY

What it does

Fxmacrodata is an agent skill from Anil-matcha/awesome-muse-connectors. Macroeconomic releases, release calendars, and FX spot rates from official sources. Read-only. Trigger phrases: fxmacrodata, cpi release, inflation data, non-farm payrolls, policy rate, economic calendar, fx rate.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/fxmacrodata.py`).

The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

When your agent uses it

  • Phrases: fxmacrodata
  • Non-farm payrolls
  • Economic calendar

Example prompts

  • “/fxmacrodata”

Requirements

  • Python 3
  • A credential in FXMACRODATA_API_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. This connector is read-only: every call is a GET. It never places trades, changes an account, or sends anything on the user's behalf.
  2. When freemium_delay.withheld_count is above zero, a newer release exists but is not shown yet. Say so and do not present the older value…
  3. When freemium_window is present, the history was cut to the last 90 days. Do not describe it as the full series.
  4. Report HTTP errors verbatim (api_key_required, invalid_api_key, and so on). A 401 means the data needs a key, not that it is missing.
  5. Quote the row's source and source_url when citing a figure. This is data, not financial advice.
  6. Never print, log, or transmit the key value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • fxmacrodata.com
    • api.fxmacrodata.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FXMACRODATA_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fxmacrodata loads about 1.1k tokens when it runs. Until then it costs about 56 tokens; SKILL.md has 462 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~56
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 462 words, ~1,131 tokens.

Download SKILL.mdSave it as .claude/skills/fxmacrodata/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
fxmacrodata
description
Macroeconomic releases, release calendars, and FX spot rates from official sources. Read-only. Trigger phrases: fxmacrodata, cpi release, inflation data, non-farm payrolls, policy rate, economic calendar, fx rate.
metadata.includeInPrompt
true
tagline
Macro indicator history, release calendars, and FX spot rates for 22 currencies. Read-only; USD works without a key.
catalog_auth
FXMacroData API key (per-user, optional for USD data)
catalog_hosts
api.fxmacrodata.com

FXMacroData

Purpose

Read-only macroeconomic and FX data from FXMacroData: the indicator catalogue for a currency, the release history of one indicator (CPI, payrolls, policy rate, bond yields and so on, each row with its official source link), upcoming release dates, and daily FX spot rates. Use when the user asks for a macro release, an economic calendar, or an exchange rate.

Currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD.

Source: the public OpenAPI spec at https://api.fxmacrodata.com/openapi.json and the reference at https://fxmacrodata.com/documentation/reference, both checked on 2026-10-04.

Tooling

All commands go through bin/fxmacrodata.py. Each prints the API's JSON response unchanged.

bash
bin/fxmacrodata.py status                                   # GET /v1/health, plus which auth mode is in use
bin/fxmacrodata.py catalogue USD                            # GET /v1/data_catalogue/USD: indicator slugs, units, coverage
bin/fxmacrodata.py history USD inflation --limit 12         # GET /v1/announcements/USD/inflation, most recent first
bin/fxmacrodata.py history USD non_farm_payrolls --start 2026-01-01 --end 2026-09-30
bin/fxmacrodata.py calendar USD --start 2026-10-01 --end 2026-10-31   # GET /v1/calendar/USD
bin/fxmacrodata.py calendar USD --indicator inflation
bin/fxmacrodata.py forex EUR USD --limit 20                 # GET /v1/forex/EUR/USD (API key required)

history and forex take --start/--end (YYYY-MM-DD) and --limit (1-100). calendar takes --indicator, --start, and --end. Use catalogue to find the indicator slug before calling history.

Auth

  • Provider id: fxmacrodata (credential is collected as custom.fxmacrodata)
  • Collection: API key via the secure credential flow (credentials.request_api_access). Outside Muse, the CLI reads the key from the FXMACRODATA_API_KEY environment variable. It never accepts a key as an argument.
  • Connect placement: custom_header:X-API-Key (the key is never put in the query string)
  • Required scopes: none; the API has no scopes. Access depends on the key's plan.
  • Allowed hosts: api.fxmacrodata.com (HTTPS only; redirects to any other host are refused)
  • Status check: bin/fxmacrodata.py status. The health check does not need a key; bin/fxmacrodata.py forex EUR USD --limit 1 confirms a key works.

Without a key, USD data still works: catalogue, history, and calendar. The catalogue answers for every currency. Keyless USD history is delayed by 15 minutes and limited to the last 90 days. Those responses carry freemium_delay and freemium_window objects, which the CLI also summarises on stderr. Other currencies' history and calendar, and all FX rates, return HTTP 401 api_key_required without a key.

Show full SKILL.md (164 more words)Show less

Operating Rules

  1. This connector is read-only: every call is a GET. It never places trades, changes an account, or sends anything on the user's behalf.
  2. When freemium_delay.withheld_count is above zero, a newer release exists but is not shown yet. Say so and do not present the older value as the latest.
  3. When freemium_window is present, the history was cut to the last 90 days. Do not describe it as the full series.
  4. Report HTTP errors verbatim (api_key_required, invalid_api_key, and so on). A 401 means the data needs a key, not that it is missing.
  5. Quote the row's source and source_url when citing a figure. This is data, not financial advice.
  6. Never print, log, or transmit the key value.

Files

  • SKILL.md
  • bin/fxmacrodata.py

Maturity

🧪 Draft: keyless USD commands (status, catalogue, history, calendar) were live-tested against api.fxmacrodata.com on 2026-10-04, as was the 401 path for forex and non-USD history. Keyed calls and the Muse credential flow have not been tested end-to-end.

© Anil-matcha, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in connectors/fxmacrodata of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/fxmacrodata.py

Open the folder on GitHubat commit d6dc5d8

Compare with similar skills

Fxmacrodata next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fxmacrodata compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fxmacrodata this skillAnil-matcha/awesome-muse-connectors1.3k—~1.1kAutomated safety check: PassMIT
Fxmacrodatasickn33/agentic-awesome-skills47k1 repos~2.9kAutomated safety check: PassMIT
Fxmacrodatadavepoon/buildwithclaude3.6k—~1.1kAutomated safety check: PassMIT
Fxmacrodata Calendartradermonty/claude-trading-skills3k—~482Automated safety check: PassMIT
Releasepaperclipai/paperclip99k—~2.4kAutomated safety check: PassMIT
Release Generate Release Notesmountain-loop/yaak19k—~548Automated safety check: PassMIT

Similar skills

  • Fxmacrodata

    sickn33/agentic-awesome-skills

    Query FXMacroData for official-source macro indicators, release calendars, central-bank policy rates, FX rates and CFTC positioning across 22 currencies.

    47k GitHub starsUsed in 1 repo~2.9k tokens
    Marketing & SEOAuto-check passed
  • Fxmacrodata

    davepoon/buildwithclaude

    Look up official macroeconomic releases, central-bank policy rates, release calendars and FX rates for 22 currencies through the FXMacroData MCP server.

    3.6k GitHub stars~1.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Fxmacrodata Calendar

    tradermonty/claude-trading-skills

    Fetch official FXMacroData macro release-calendar events for trade planning, macro regime checks, and event-risk filters.

    3k GitHub stars~482 tokensUpdated 2 days ago
    Auto-check passed
  • Release

    paperclipai/paperclip

    Coordinate a full Paperclip release across engineering verification, npm, GitHub, smoke testing, and announcement follow-up.

    99k GitHub stars~2.4k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Generate Yaak release notes from git history and PR metadata, including feedback links and full changelog compare links.

    19k GitHub stars~548 tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Verify Release

    openclaw/openclaw

    Verify regular or extended-stable OpenClaw releases against the exact publication surfaces, workflow identities, package provenance, smoke tests, and live Gateway behavior expected for that release…

    392k GitHub stars~2.4k tokensUpdated today
    Testing & QAAuto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~511 tokens
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub starsUsed in 1 repo~481 tokens
    Auto-check passed
  • Attio

    Anil-matcha/awesome-muse-connectors

    Read and write Attio: list objects, query records, upsert records, add notes and tasks.

    1.3k GitHub starsUsed in 1 repo~621 tokens
    Auto-check passed
  • Beatoven

    Anil-matcha/awesome-muse-connectors

    Beatoven.ai royalty-free music generation: compose tracks, poll tasks, download audio, fetch individual stems.

    1.3k GitHub starsUsed in 1 repo~823 tokens
    Auto-check passed
  • Clickup

    Anil-matcha/awesome-muse-connectors

    List ClickUp workspaces and tasks, and create tasks. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~515 tokens
    Auto-check passed

Questions about Fxmacrodata

What does Fxmacrodata do?

Macroeconomic releases, release calendars, and FX spot rates from official sources. Fxmacrodata is an agent skill from Anil-matcha/awesome-muse-connectors. Macroeconomic releases, release calendars, and FX spot rates from official sources.

When should I use Fxmacrodata?

Fxmacrodata fits situations like: phrases: fxmacrodata; non-farm payrolls; economic calendar.

How do I install Fxmacrodata in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill fxmacrodata -a claude-code`. Or copy the skill folder (connectors/fxmacrodata in Anil-matcha/awesome-muse-connectors) into .claude/skills/fxmacrodata in your project. Claude Code loads it when a task matches its description.

How do I install Fxmacrodata in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill fxmacrodata -a codex`. Or copy the skill folder (connectors/fxmacrodata in Anil-matcha/awesome-muse-connectors) into .agents/skills/fxmacrodata in your project. Codex loads it when a task matches its description.

Can I use Fxmacrodata in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Anil-matcha/awesome-muse-connectors --skill fxmacrodata -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fxmacrodata, .gemini/skills/fxmacrodata, .github/skills/fxmacrodata and .opencode/skills/fxmacrodata in your project.

What does Fxmacrodata need to run?

Going by SKILL.md and its folder, Fxmacrodata needs Python for the scripts in its folder and credentials named FXMACRODATA_API_KEY. Our summary lists: Python 3; A credential in FXMACRODATA_API_KEY.

Does Fxmacrodata access the network?

SKILL.md names 2 domains. As links in the text: fxmacrodata.com and api.fxmacrodata.com. This is read from the text; nothing was executed.

Is Fxmacrodata safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fxmacrodata use?

Fxmacrodata is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fxmacrodata use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fxmacrodata?

Skills that share tags, products or a category with Fxmacrodata: Fxmacrodata (sickn33/agentic-awesome-skills, 47k stars), Fxmacrodata (davepoon/buildwithclaude, 3.6k stars), Fxmacrodata Calendar (tradermonty/claude-trading-skills, 3k stars) and Release (paperclipai/paperclip, 99k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fxmacrodata?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,338 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.