{
  "markdown": "# Visa AI\n\nAI 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.\n\n## What's Inside\n\n| Directory / File | Description |\n|---|---|\n| [`packages/`](#packages) | Reusable npm packages for Visa API integration |\n| [`apps/`](#client-usage-examples) | Client usage examples (MCP, VIC API, VDP API) |\n| [`vic-agent/`](#agent-demo) | AI agent demonstrating VTS card tokenization and Visa Passkey usage (LangGraph + Next.js) |\n| [`skills/`](#skills-claude-code) | AI assistant skills for Claude Code |\n| [`gemini-extension.json`](#gemini-cli-extension) | Gemini CLI extension for Visa Documentation MCP Server (VIC + VDP) |\n\n## Packages\n\nReusable Node.js/TypeScript packages for Visa API integration:\n\n- **[@visa/token-manager](./packages/token-manager)** - JWE token generation and management for MCP authentication\n- **[@visa/mcp-client](./packages/mcp-client)** - MCP client for connecting to Visa MCP server with automatic authentication\n- **[@visa/api-client](./packages/api-client)** - API clients for VIC and VDP with X-Pay authentication and MLE encryption\n\n## Client Usage Examples\n\nWorking examples in the [`apps/`](./apps) directory:\n\n- **[vic-mcp-examples/](./apps/vic-mcp-examples)** - MCP server connection, tool invocation, and workflow orchestration\n- **[vic-api-examples/](./apps/vic-api-examples)** - Direct REST API integration with X-Pay authentication and MLE encryption\n- **[vdp-api-examples/](./apps/vdp-api-examples)** - VDP connectivity testing with X-Pay authentication\n\n## Agent Demo\n\nThe [`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:\n\n- Card tokenization via VTS\n- Device binding with FIDO authentication\n- Step-up verification and Visa Payment Passkey creation\n- Assurance data collection and VIC enrollment\n\nSee [vic-agent/README.md](./vic-agent/README.md) for setup instructions.\n\n## Skills (Claude Code)\n\nThe [`skills/`](./skills) directory contains skills for Claude Code that provide best practices and integration guidance for the Visa Developer Platform.\n\nInstall a skill into your project:\n\n```bash\ngit clone https://github.com/visa/ai.git\ncp -r ai/skills/<skill-name> <your-project>/.claude/skills/\n```\n\nSee [skills/README.md](./skills/README.md) for available skills and installation options.\n\n## Gemini CLI Extension\n\nThe [`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.\n\n```bash\ngemini extensions install https://github.com/visa/ai\n```\n\nFor details, visit the [Documentation MCP Server Wiki page](https://github.com/visa/ai/wiki/Documentation-MCP-Server).\n\n## Documentation MCP Server\n\nA dedicated MCP server that provides AI agents with integration guides, examples, and tool definitions for Visa APIs.\n\n**Endpoint:** `https://sandbox.mcp.visa.com/mcp/doc`\n\n- **get-docs** tool for retrieving structured documentation\n- Authentication patterns, payload schemas, and best practices\n- MCP and direct API integration guides\n\n**Learn more:** [Documentation MCP Server Wiki](https://github.com/visa/mcp/wiki/Documentation-MCP-Server)\n\n## Visa Intelligent Commerce\n\nVisa Intelligent Commerce (VIC) enables AI agents to securely browse, shop, and purchase on behalf of consumers using tokenized digital credentials and integrated APIs.\n\nFor 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).\n\n## Visa APIs and Integration\n\n- [Visa Intelligent Commerce Capabilities](https://developer.visa.com/capabilities/visa-intelligent-commerce) - Overview of VIC features and capabilities\n- [Visa Developer Center](https://developer.visa.com) - Main portal for Visa API documentation, credentials, and testing environments\n- [Visa MCP Hub](https://mcp.visa.com) - Central hub for Model Context Protocol server information and integration\n- [Visa Developer Quick Start Guide](https://developer.visa.com/pages/working-with-visa-apis/visa-developer-quick-start-guide) - Getting started with Visa APIs\n- [X-Pay Token Authentication](https://developer.visa.com/pages/working-with-visa-apis/x-pay-token) - Guide for implementing X-Pay token-based authentication\n- [Encryption Guide](https://developer.visa.com/pages/encryption_guide) - Message Level Encryption (MLE) documentation and best practices\n\n## Building the Project\n\nThis repository uses npm workspaces with Turbo for efficient build orchestration.\n\n### Initial Setup\n\n```bash\n# Install all dependencies (one command for everything)\nnpm install\n```\n\nThis installs dependencies for all packages and apps at once, using npm workspaces to hoist shared dependencies to the root.\n\n### Build Commands\n\n```bash\n# Build all packages and apps\nnpm run build\n\n# Build only packages (token-manager, mcp-client, api-client)\nnpm run build:packages\n\n# Build only apps (vic-mcp-examples, vic-api-examples, vdp-api-examples)\nnpm run build:apps\n\n# Build packages and agent\nnpm run build:agent\n\n# Clean all build artifacts\nnpm run clean\n```\n\n## License\n\nSee LICENSE file for details",
  "bytes": 5466,
  "sha": "2c50ca532b579400d0b503cf867c73f8f1b09959eb132c0a708308531a1eb089",
  "repo_slug": "visa/ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_visa_ai_52a4738c/readme"
}