Privacy MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'privacymcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Privacy MCP:', link)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'privacymcp_list_cards',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "privacymcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Privacy MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="privacymcp_list_cards",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Update card spend limit, card memo — Update the spend limit and optional reset duration for a virtual card
• Card unpause, pause, close — Re-enable transactions on a previously paused virtual card
• List transactions, cards — List transactions on your Privacy.com account, with optional filters for card, date range, and result
• Get pan, card — Retrieve the full card number (PAN), CVV2, and expiration date for a virtual card
• Create card — Create a new virtual card on your Privacy.com account with optional spend limits and memo

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

privacymcp_close_card # Permanently close a virtual card, blocking all future transactions. This action is irreversible. 1 param ▾

Permanently close a virtual card, blocking all future transactions. This action is irreversible.

Name Type Required Description

card_token string required Token of the card

privacymcp_create_card # Create a new virtual card on your Privacy.com account with optional spend limits and memo. 5 params ▾

Create a new virtual card on your Privacy.com account with optional spend limits and memo.

Name Type Required Description

type string required Card type: SINGLE_USE (closes after first use), MERCHANT_LOCKED (locks to first merchant)

memo string optional Friendly name for the card

spend_limit number optional Spend limit in dollars (e.g. 25.00)

spend_limit_duration string optional How the spend limit resets: per TRANSACTION, MONTHLY, ANNUALLY, or FOREVER (lifetime)

state string optional Initial card state (default: OPEN)

privacymcp_get_card # Retrieve details for a specific virtual card by its token, including type, state, and spend limits. 1 param ▾

Retrieve details for a specific virtual card by its token, including type, state, and spend limits.

Name Type Required Description

card_token string required Token of the card to retrieve

privacymcp_get_pan # Retrieve the full card number (PAN), CVV2, and expiration date for a virtual card. Returns sensitive data. 1 param ▾

Retrieve the full card number (PAN), CVV2, and expiration date for a virtual card. Returns sensitive data.

Name Type Required Description

card_token string required Token of the card to retrieve

privacymcp_list_cards # List all virtual cards on your Privacy.com account with optional pagination. 2 params ▾

List all virtual cards on your Privacy.com account with optional pagination.

Name Type Required Description

page integer optional Page number for pagination (1-indexed)

page_size integer optional Number of cards per page (1-100, default 20)

privacymcp_list_transactions # List transactions on your Privacy.com account, with optional filters for card, date range, and result. 7 params ▾

List transactions on your Privacy.com account, with optional filters for card, date range, and result.

Name Type Required Description

account_token string optional Filter transactions by account token

begin string optional Start date (inclusive) in YYYY-MM-DD format

card_token string optional Filter transactions by card token

end string optional End date (exclusive) in YYYY-MM-DD format

page integer optional Page number for pagination (1-indexed)

page_size integer optional Number of transactions per page (1-1000, default 20)

result string optional Filter by transaction result

privacymcp_pause_card # Pause a virtual card to temporarily block all transactions until it is unpaused. 1 param ▾

Pause a virtual card to temporarily block all transactions until it is unpaused.

Name Type Required Description

card_token string required Token of the card

privacymcp_unpause_card # Re-enable transactions on a previously paused virtual card. 1 param ▾

Re-enable transactions on a previously paused virtual card.

Name Type Required Description

card_token string required Token of the card

privacymcp_update_card_memo # Update the memo (friendly name) on a virtual card. 2 params ▾

Update the memo (friendly name) on a virtual card.

Name Type Required Description

card_token string required Token of the card to update

memo string required New friendly name for the card

privacymcp_update_card_spend_limit # Update the spend limit and optional reset duration for a virtual card. 3 params ▾

Update the spend limit and optional reset duration for a virtual card.

Name Type Required Description

card_token string required Token of the card to update

spend_limit number required New spend limit in dollars (e.g. 25.00)

spend_limit_duration string optional How the spend limit resets: per TRANSACTION, MONTHLY, ANNUALLY, or FOREVER (lifetime). If omitted, keeps the current duration.