> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to CurrencyBeacon

The CurrencyBeacon connector lets your AI agent act in each user's CurrencyBeacon account. Each user connects their own CurrencyBeacon access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 5 tools.

**Authentication:** Bearer Token
**Categories:** Accounting & Finance
**Tools:** 5: 5 read, 0 write, 0 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CURRENCYBEACON)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the CurrencyBeacon connection

   In **AgentKit > Connections**, create a CurrencyBeacon connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'currencybeacon'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize CurrencyBeacon:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'currencybeacon_currencies_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "currencybeacon"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize CurrencyBeacon:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="currencybeacon_currencies_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their CurrencyBeacon credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'currencybeacon_convert',
  toolInput: {
    amount: 100,
    from: '<from>',
    to: '<to>',
  },
  connector: 'currencybeacon',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="currencybeacon_convert",
    tool_input={
        "amount": 100,
        "from": "<from>",
        "to": "<to>",
    },
    connection_name="currencybeacon",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `currencybeacon_convert`

Convert Currency · Read-only

Convert an amount from one currency to another at the mid-market rate, now or on a past date.
Returns meta and response with timestamp, date, from, to, amount and value (the converted amount).
Use this instead of multiplying rates yourself.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to convert. Example: 100.
- `from` (`string`, required): Three-letter code of the currency to convert from. Example: USD.
- `to` (`string`, required): Three-letter code of the currency to convert to. Example: JPY.
- `date` (`string`, optional): Use rates from this past date (YYYY-MM-DD) instead of today. Example: 2024-03-15.

Example input: `{"amount":100,"from":"<from>","to":"<to>"}`

### `currencybeacon_currencies_list`

List Supported Currencies · Read-only

List every currency CurrencyBeacon supports, with names, symbols and ISO codes.
Returns meta and response with the supported currencies.
Use this to validate currency codes before the rate tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `currencybeacon_rates_historical_get`

Get Historical Exchange Rates · Read-only

Get exchange rates for a specific past date, back to 1996.
Returns meta and response with date, base and rates.
Use this for accounting and audits. Use currencybeacon_timeseries_get for a range of dates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `date` (`string`, required): Date in YYYY-MM-DD format. Example: 2023-12-25.
- `base` (`string`, optional): Three-letter code of the base currency. Defaults to USD. Example: USD.
- `symbols` (`string`, optional): Comma-separated currency codes to return. Leave empty for all currencies. Example: EUR,GBP,JPY.

Example input: `{"date":"<date>"}`

### `currencybeacon_rates_latest_get`

Get Latest Exchange Rates · Read-only

Get real-time exchange rates from a base currency to all or selected fiat currencies and cryptocurrencies.
Returns meta and response with date, base and rates (currency code to rate).
Use this for current rates. Use currencybeacon_rates_historical_get for a past date and currencybeacon_convert to convert an amount.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `base` (`string`, optional): Three-letter code of the base currency. Defaults to USD. Example: USD.
- `symbols` (`string`, optional): Comma-separated currency codes to return. Leave empty for all currencies. Example: EUR,GBP,JPY.

Example input: `{}`

### `currencybeacon_timeseries_get`

Get Exchange Rate Time Series · Read-only

Get daily exchange rates between two dates.
Returns meta and response with rates for each day in the range.
Use this for charts and volatility analysis. Available on the Startup and Professional plans only (other plans get 403); the maximum range depends on the plan, typically 365 days.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `end_date` (`string`, required): Last date of the range, YYYY-MM-DD. Example: 2024-03-15.
- `start_date` (`string`, required): First date of the range, YYYY-MM-DD. Example: 2024-01-01.
- `base` (`string`, optional): Three-letter code of the base currency. Defaults to USD. Example: USD.
- `symbols` (`string`, optional): Comma-separated currency codes to return. Leave empty for all currencies. Example: EUR,GBP,JPY.

Example input: `{"end_date":"<end_date>","start_date":"<start_date>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
