@agentos-sui/mcp

MCP server for SuiNS AgentOS. Exposes AgentOS as tools for Cursor, Claude Code, Kiro, Codex, and any MCP-compatible AI IDE.

What it does

Lets your AI assistant resolve, publish, and execute Sui agents/skills via natural language — no TypeScript required.

Setup

No install needed — runs via npx.

Cursor

.cursor/mcp.json:

{
"mcpServers": {
"agentos": {
"command": "npx",
"args": ["-y", "@agentos-sui/mcp"],
"env": {
"AGENTOS_PACKAGE_ID": "0xYOUR_PACKAGE_ID",
"SUI_RPC_URL": "https://fullnode.testnet.sui.io"
}
}
}
}

Claude Code

claude mcp add agentos npx -y @agentos-sui/mcp

Kiro

.kiro/settings/mcp.json:

{
"mcpServers": {
"agentos": {
"command": "npx",
"args": ["-y", "@agentos-sui/mcp"],
"env": {
"AGENTOS_PACKAGE_ID": "0xYOUR_PACKAGE_ID"
}
}
}
}

Available tools

| Tool | Description | | -------------------------- | ---------------------------------------------------- | | agentos_resolve | Resolve .sui agent name → passport + skills | | agentos_register_agent | Register agent locally (dev only) | | agentos_publish_skill | Upload manifest to Walrus + mint descriptor on-chain | | agentos_execute_skill | Resolve, verify, and execute a skill on-chain | | agentos_resolve_manifest | Fetch + verify skill manifest from Walrus | | agentos_list_skills | List all skills owned by an agent | | agentos_import_skill | Import a skill .md manifest from disk | | agentos_dashboard_url | Get dashboard URL for browser-based flows |

Environment variables

| Variable | Required | Default | | ------------------------- | ------------------ | ------------------------ | | AGENTOS_PACKAGE_ID | yes | — | | SUI_RPC_URL | no | testnet fullnode | | SUI_PRIVATE_KEY | for write ops | — | | AGENTOS_REGISTRY_PATH | no | .agentos/registry.json | | HARBOR_API_KEY | for Harbor storage | — | | AGENTOS_STORAGE_BACKEND | no | walrus |

Example prompts

• "Resolve alpha-fund.sui and list its skills"
• "Publish the manifest at ./skill.md for alpha-fund.sui"
• "Execute defi-rebalancer.alpha-fund.sui"

License

MIT