visa-intelligent-commerce
Integration toolkit for connecting AI agents to the Visa Intelligent Commerce platform.
Open source Open in the app JSON README (API)
About
Integration toolkit for connecting AI agents to the Visa Intelligent Commerce platform.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- visa
- Origin
- gemini
- Category
- ferramentas
- Version
- 25.11.00
- Stars
- 42
- Forks
- 15
- Last push
- 2026-06-12T06:38:20Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
visa/ai
README
# 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/`](#packages) | Reusable npm packages for Visa API integration | | [`apps/`](#client-usage-examples) | Client usage examples (MCP, VIC API, VDP API) | | [`vic-agent/`](#agent-demo) | AI agent demonstrating VTS card tokenization and Visa Passkey usage (LangGraph + Next.js) | | [`skills/`](#skills-claude-code) | AI assistant skills for Claude Code | | [`gemini-extension.json`](#gemini-cli-extension) | Gemini CLI extension for Visa Documentation MCP Server (VIC + VDP) | ## Packages Reusable Node.js/TypeScript packages for Visa API integration: - **[@visa/token-manager](./packages/token-manager)** - JWE token generation and management for MCP authentication - **[@visa/mcp-client](./packages/mcp-client)** - MCP client for connecting to Visa MCP server with automatic authentication - **[@visa/api-client](./packages/api-client)** - API clients for VIC and VDP with X-Pay authentication and MLE encryption ## Client Usage Examples Working examples in the [`apps/`](./apps) directory: - **[vic-mcp-examples/](./apps/vic-mcp-examples)** - MCP server connection, tool invocation, and workflow orchestration - **[vic-api-examples/](./apps/vic-api-examples)** - Direct REST API integration with X-Pay authentication and MLE encryption - **[vdp-api-examples/](./apps/vdp-api-examples)** - VDP connectivity testing with X-Pay authentication ## Agent Demo The [`vic-agent/`](./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](./vic-agent/README.md) for setup instructions. ## Skills (Claude Code) The [`skills/`](./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: ```bash git clone https://github.com/visa/ai.git cp -r ai/skills/<skill-name> <your-project>/.claude/skills/ ``` See [skills/README.md](./skills/README.md) for available skills and installation options. ## Gemini CLI Extension The [`gemini-extension.json`](./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. ```bash gemini extensions install https://github.com/visa/ai ``` For details, visit the [Documentation MCP Server Wiki page](https://github.com/visa/ai/wiki/Documentation-MCP-Server). ## 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](https://github.com/visa/mcp/wiki/Documentation-MCP-Server) ## 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](https://github.com/visa/ai/wiki/Visa-Intelligent-Commerce). ## Visa APIs and Integration - [Visa Intelligent Commerce Capabilities](https://developer.visa.com/capabilities/visa-intelligent-commerce) - Overview of VIC features and capabilities - [Visa Developer Center](https://developer.visa.com) - Main portal for Visa API documentation, credentials, and testing environments - [Visa MCP Hub](https://mcp.visa.com) - Central hub for Model Context Protocol server information and integration - [Visa Developer Quick Start Guide](https://developer.visa.com/pages/working-with-visa-apis/visa-developer-quick-start-guide) - Getting started with Visa APIs - [X-Pay Token Authentication](https://developer.visa.com/pages/working-with-visa-apis/x-pay-token) - Guide for implementing X-Pay token-based authentication - [Encryption Guide](https://developer.visa.com/pages/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 ```bash # 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 ```bash # 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