# UniRateAPI — Pipedream Connect

> Currency API for Developers

- API slug: `unirateapi` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Developer Tools
- Website: https://unirateapi.com
- This page (HTML): https://pipedream.com/apps/unirateapi
- Tools: 6 actions · 1 trigger

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: unirateapi`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "unirateapi",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Convert Currency:
const result = await mcp.callTool({
  name: "unirateapi-convert-currency",
  arguments: {
    from: "From",
    to: "To",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a UniRateAPI endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.unirateapi.com/api/currencies

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkudW5pcmF0ZWFwaS5jb20vYXBpL2N1cnJlbmNpZXM?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "unirateapi-convert-currency",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    unirateapi: { authProvisionId: "apn_xxxxxxx" },
    from: "From",
    to: "To",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (6)

### `unirateapi-convert-currency` — Convert Currency (Read-only)

Convert an amount from one currency to another at the latest rate. See the documentation.

Full schema: https://pipedream.com/apps/unirateapi/actions/convert-currency.md

### `unirateapi-get-exchange-rates` — Get Exchange Rates (Read-only)

Get the latest exchange rate(s) for a base currency. Returns a single rate when a target is provided, or all rates keyed by currency code when omitted. See the documentation.

Full schema: https://pipedream.com/apps/unirateapi/actions/get-exchange-rates.md

### `unirateapi-get-vat-rates` — Get VAT Rates (Read-only)

Get VAT rates for a single country, or for all supported countries when no country is provided. Country codes follow the EU VAT convention rather than ISO 3166-1 alpha-2 — Greece is EL (not GR) and the United Kingdom is UK (not GB). Coverage is limited to EU member states plus UK and XI (Northern…

Full schema: https://pipedream.com/apps/unirateapi/actions/get-vat-rates.md

### `unirateapi-list-country-code-options` — List Country Code Options (Read-only)

Retrieves the valid options for the Country Code field used by Get VAT Rates. Returns one entry per supported country as { label, value }, where value is the code to pass as Country Code. These follow the EU VAT convention rather than ISO 3166-1 alpha-2 — Greece is EL (not GR) and the United…

Full schema: https://pipedream.com/apps/unirateapi/actions/list-country-code-options.md

### `unirateapi-list-currencies` — List Currencies (Read-only)

List every currency code supported by UniRate for exchange rate and conversion operations. Use this to discover valid values before calling Convert Currency or Get Exchange Rates, or to check whether a currency code you already have is supported. Takes no parameters and returns the full set in a…

Full schema: https://pipedream.com/apps/unirateapi/actions/list-currencies.md

### `unirateapi-list-currency-code-options` — List Currency Code Options (Read-only)

Retrieves available options for the Currency Code field.

Full schema: https://pipedream.com/apps/unirateapi/actions/list-currency-code-options.md

## Triggers (1)

### `unirateapi-new-rate-update` — New Rate Update (Polling)

Emit new event when the exchange rate between two currencies changes. See the documentation.

Full schema: https://pipedream.com/apps/unirateapi/triggers/new-rate-update.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt