> For the complete documentation index, see [llms.txt](https://docs.vultisig.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vultisig.com/developer-docs/ai-agents/integration-options.md).

# Vultisig agent integration options

Choose between the Vultisig CLI, TypeScript SDK, Marketplace plugins, and MCP tooling for AI agent integrations.

## CLI (start here)

The CLI is the fastest way to give an AI agent a wallet. Any agent that can run shell commands gets multi-chain balances, sends, swaps, and signing — through structured JSON, stable exit codes, and a natural-language `agent ask` mode built for AI-to-AI use. No SDK build step, no embedding.

```bash
npm install -g @vultisig/cli

# Structured wallet commands
vultisig portfolio --output json
vultisig swap-quote ethereum bitcoin 0.1 --output json
vultisig swap ethereum bitcoin 0.1 --output json

# Natural-language, one-shot — designed for AI agent integration
vultisig agent ask "What is my ETH balance?" --password "$VAULT_PASSWORD" --json
```

The CLI auto-detects non-interactive (non-TTY) environments and skips the prompts that would otherwise hang an agent, so the same commands run unattended in scripts and pipelines. Set `VAULT_PASSWORD` to avoid interactive password entry, and branch on the documented exit codes and error codes for reliable orchestration.

See the [CLI reference](/developer-docs/vultisig-sdk/cli.md), including the AI agent integration guide.

## TypeScript SDK

Use `@vultisig/sdk` when you are embedding wallet capabilities directly into your own agent, bot, or service in TypeScript. The SDK handles vault creation, balances, portfolio tracking, sends, swaps, message signing, and transaction broadcasting.

```typescript
import { Chain, Vultisig } from '@vultisig/sdk'

const sdk = new Vultisig()
await sdk.initialize()

const vault = await sdk.getActiveVault()
if (!vault) throw new Error('No active vault')

const portfolio = await vault.portfolio('usd')
const preview = await vault.send({
  chain: Chain.Ethereum,
  to: '0xRecipient',
  amount: '0.1',
  dryRun: true,
})
```

Start with the [SDK guide](/developer-docs/vultisig-sdk.md) and [implementation guide](/developer-docs/vultisig-sdk/sdk-users-guide.md).

## Marketplace plugins

{% hint style="warning" %}
**Paused.** The plugin marketplace is not in production. These pages describe the planned product and stay for reference.
{% endhint %}

Use a Marketplace plugin when an agent should act within user-defined rules instead of receiving broad wallet authority. The plugin proposes an unsigned transaction; the Verifier checks the proposal before participating in signing.

Start with the [Marketplace developer docs](/developer-docs/marketplace.md).

## Agent discovery resources

| Resource                                                  | Purpose                                                                                                                       |
| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| [SKILL.md](https://vultisig.com/SKILL.md)                 | Operating instructions for balances, sends, swaps, gas estimation, and vault workflows                                        |
| [llms.txt](https://vultisig.com/llms.txt)                 | Compact documentation index                                                                                                   |
| [llms-full.txt](https://vultisig.com/llms-full.txt)       | Full SDK context and examples                                                                                                 |
| [agent.json](https://vultisig.com/.well-known/agent.json) | Structured capabilities manifest                                                                                              |
| MCP (`@vultisig/mcp` in the SDK repo)                     | MCP tools for multi-chain queries, unsigned transaction building, and DeFi. Plugin management is paused with the marketplace. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.vultisig.com/developer-docs/ai-agents/integration-options.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.