Visa AI

AI tools, examples, and integrations for the Visa Developer Platform. This repository brings together reusable packages, client examples, an AI agent demo, Claude Code skills, a Gemini CLI extension, and documentation resources for building AI-powered experiences with Visa APIs.

What's Inside

Directory / File	Description
packages/	Reusable npm packages for Visa API integration
apps/	Client usage examples (MCP, VIC API, VDP API)
vic-agent/	AI agent demonstrating VTS card tokenization and Visa Passkey usage (LangGraph + Next.js)
skills/	AI assistant skills for Claude Code
gemini-extension.json	Gemini CLI extension for Visa Documentation MCP Server (VIC + VDP)

Packages

Reusable Node.js/TypeScript packages for Visa API integration:

• @visa/token-manager - JWE token generation and management for MCP authentication
• @visa/mcp-client - MCP client for connecting to Visa MCP server with automatic authentication
• @visa/api-client - API clients for VIC and VDP with X-Pay authentication and MLE encryption

Client Usage Examples

Working examples in the apps/ directory:

• vic-mcp-examples/ - MCP server connection, tool invocation, and workflow orchestration
• vic-api-examples/ - Direct REST API integration with X-Pay authentication and MLE encryption
• vdp-api-examples/ - VDP connectivity testing with X-Pay authentication

Agent Demo

The vic-agent/ directory contains a LangGraphJS-powered AI agent with a Next.js UI that demonstrates VTS card tokenization and Visa Passkey usage:

• Card tokenization via VTS
• Device binding with FIDO authentication
• Step-up verification and Visa Payment Passkey creation
• Assurance data collection and VIC enrollment

See vic-agent/README.md for setup instructions.

Skills (Claude Code)

The skills/ directory contains skills for Claude Code that provide best practices and integration guidance for the Visa Developer Platform.

Install a skill into your project:

git clone https://github.com/visa/ai.git
cp -r ai/skills/<skill-name> <your-project>/.claude/skills/

See skills/README.md for available skills and installation options.

Gemini CLI Extension

The gemini-extension.json file provides a Gemini CLI extension that connects to the Visa Documentation MCP Server, giving Gemini access to VIC and VDP integration guides and tool definitions.

gemini extensions install https://github.com/visa/ai

For details, visit the Documentation MCP Server Wiki page.

Documentation MCP Server

A dedicated MCP server that provides AI agents with integration guides, examples, and tool definitions for Visa APIs.

Endpoint: https://sandbox.mcp.visa.com/mcp/doc

• get-docs tool for retrieving structured documentation
• Authentication patterns, payload schemas, and best practices
• MCP and direct API integration guides

Learn more: Documentation MCP Server Wiki

Visa Intelligent Commerce

Visa Intelligent Commerce (VIC) enables AI agents to securely browse, shop, and purchase on behalf of consumers using tokenized digital credentials and integrated APIs.

For a full overview of the platform, how it works, and integration resources, see the Visa Intelligent Commerce wiki page.

Visa APIs and Integration

• Visa Intelligent Commerce Capabilities - Overview of VIC features and capabilities
• Visa Developer Center - Main portal for Visa API documentation, credentials, and testing environments
• Visa MCP Hub - Central hub for Model Context Protocol server information and integration
• Visa Developer Quick Start Guide - Getting started with Visa APIs
• X-Pay Token Authentication - Guide for implementing X-Pay token-based authentication
• Encryption Guide - Message Level Encryption (MLE) documentation and best practices

Building the Project

This repository uses npm workspaces with Turbo for efficient build orchestration.

Initial Setup

# Install all dependencies (one command for everything)
npm install

This installs dependencies for all packages and apps at once, using npm workspaces to hoist shared dependencies to the root.

Build Commands

# Build all packages and apps
npm run build

# Build only packages (token-manager, mcp-client, api-client)
npm run build:packages

# Build only apps (vic-mcp-examples, vic-api-examples, vdp-api-examples)
npm run build:apps

# Build packages and agent
npm run build:agent

# Clean all build artifacts
npm run clean

License

See LICENSE file for details