Skip to content

awesamarth/agentis

Repository files navigation

Agentis

Complete financial infrastructure for AI agents on Solana.

Agentis gives AI agents wallets, payment rails, spending controls, privacy flows, and yield access. It is built for agents that need to hold funds, pay for work, obey budgets, move privately, and put idle capital to use.

Agentis is live at agentis.systems. Documentation is available at docs.agentis.systems.

Why Agentis

AI agents are starting to transact onchain. They need to pay APIs, access x402 and MPP endpoints, interact with protocols, coordinate with other agents, and move funds on behalf of users.

A wallet alone is not enough for that. A serious spending agent needs:

  • a wallet it can operate
  • policy limits before money moves
  • payment support for machine-payable endpoints
  • privacy when flows should not be public
  • yield for idle funds
  • interfaces that both humans and agents can use

Agentis brings those pieces into one Solana-native control plane.

What Agentis Includes

Agent wallets

Create hosted agent wallets from the dashboard, CLI, or MCP server. Agentis also supports local encrypted wallets through the CLI for users who want local custody.

Payments

Agents can pay x402 and MPP protected endpoints through the Agentis SDK, CLI, or MCP server. agentis.fetch() and agentis fetch handle payment-required responses, check policy, and route the payment through the selected agent wallet.

Policy enforcement

Agentis policies are checked before spends happen. Policies can include max-per-transaction limits, daily budgets, total budgets, allowed domains, and kill switches. Quasar-based on-chain policy checks are supported for direct SOL sends on Solana devnet.

Privacy

Private agent wallets use Umbra privacy flows. Agents can register for privacy, inspect encrypted balance, deposit, withdraw, create receiver-claimable UTXOs, scan, and claim.

Jupiter Earn

Agentis can deposit idle mainnet USDC into Jupiter Earn, show Earn positions, withdraw supplied USDC, and sweep non-zero USDC balances across hosted agents.

Human and agent interfaces

Agentis can be operated from:

  • Dashboard, for humans managing agents visually
  • CLI, for local workflows and scripts
  • SDK, for apps and agent runtimes
  • MCP, for AI assistants and coding agents
  • SKILL.md, so agents can understand how to use Agentis

Quick Start

Create an account on the Agentis dashboard, then create and fund an agent wallet.

Set policy limits before giving an AI agent control:

  • max per transaction
  • daily or monthly budget
  • allowed domains
  • kill switch

Then install the Agentis skill in your AI agent environment:

npx skills add awesamarth/agentis

The intended flow is: a human creates an agent wallet, applies policy, then an AI agent operates that wallet through Agentis while staying inside those limits. You can control the same wallet from the dashboard, CLI, SDK, MCP server, or through an AI agent using the Agentis skill.

For local assistants and coding agents with shell access, install the CLI first. The Agentis skill gives the agent enough context to use agentis --help, pick the right commands, and operate wallets through the CLI:

npm install -g @agentis-hq/cli
agentis login
agentis agent list
agentis fetch https://example.com/paid-data --agent my-agent

Use MCP as the secondary path when you do not want a global CLI installed, or when your AI agent host already has Agentis MCP tools connected.

See the quick start docs for the full path.

Agent Skill

Agentis includes an installable SKILL.md for compatible coding agents. The skill tells an AI agent how to choose between the dashboard, CLI, SDK, and MCP server, and how to operate Agentis safely.

Install it with the Vercel Agent Skills CLI:

npx skills add awesamarth/agentis

The skill lives at skills/agentis/SKILL.md.

CLI

Install globally:

npm install -g @agentis-hq/cli
agentis

Common commands:

agentis login
agentis wallet create --name my-agent
agentis wallet create --name local-agent --local
agentis agent list
agentis agent balance my-agent
agentis fetch https://example.com/paid-data --agent my-agent
agentis policy set my-agent --max-per-tx 1 --daily 10
agentis earn positions my-agent --mainnet
agentis privacy status --agent my-agent

Read the CLI docs or the package README at packages/cli.

SDK

Install:

npm install @agentis-hq/sdk

Use Agentis from an app backend or agent runtime:

import { AgentisClient } from '@agentis-hq/sdk'

const agentis = await AgentisClient.create({
  apiKey: process.env.AGENTIS_API_KEY!,
})

const res = await agentis.fetch('https://example.com/paid-data')
const data = await res.json()

await agentis.policy.update({
  maxPerTx: 1,
  dailyLimit: 10,
})

The SDK is intended for trusted server-side or agent-runtime environments. Do not expose Agentis API keys in browser clients.

Read the SDK docs or the package README at packages/sdk.

MCP

Agentis ships a local stdio MCP server for AI assistants that support MCP.

npm install -g @agentis-hq/mcp

Example MCP config:

{
  "mcpServers": {
    "agentis": {
      "command": "agentis-mcp",
      "env": {
        "AGENTIS_ACCOUNT_KEY": "agt_user_..."
      }
    }
  }
}

The MCP server exposes account-level tools for listing agents, creating agents, reading balances, sending SOL, fetching paid URLs, updating policy, using Jupiter Earn, and operating Umbra privacy flows.

Read the MCP docs or the package README at packages/mcp.

Packages

Package Purpose
@agentis-hq/core Shared types and policy engine
@agentis-hq/sdk Runtime SDK for agent wallets and paid fetches
@agentis-hq/cli Command line interface
@agentis-hq/mcp Local stdio MCP server

Security Model

Agentis separates account access from agent access.

  • Account keys are used by the CLI and MCP server to operate an account's agents.
  • Agent API keys are scoped to individual agent wallets and are used by the SDK.
  • Full keys are shown only when created or regenerated.
  • Backend reads return masked key metadata, not plaintext keys.
  • Policies are checked before signing or proxying spends.

Mainnet actions, including Jupiter Earn, move real funds. Review agent policies and balances before enabling autonomous workflows.

Status

Agentis is early, live, and actively changing. The current product supports hosted agent wallets, local CLI wallets, policy controls, x402/MPP paid fetches, Umbra privacy flows, Jupiter Earn, the dashboard, CLI, SDK, MCP server, and agent skill instructions.

Swaps, richer production observability, and exportable self-custodial hosted wallets are planned next steps.

Links

About

Complete financial infrastructure for AI agents on Solana

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors