Skip to main content
ProductsPricingDocsBlogSign in한국어Get started

Tools and CLI Commands

One AiNecto MCP server provides workspace and document tools together with ERD, diagram, and Markdown tools. This page lists the kinds of tools your Agent receives and the AiNecto CLI commands. To connect, see Connect the Agent You Already Use. For connection problems, see CLI and Connection Troubleshooting.

Reading tool names​

Your Agent puts the server name you chose when connecting in front of each tool name. If you registered the server as ainecto, Claude Code shows mcp__ainecto__list_projects. Check the exact list in your Agent's MCP tools screen. When the server adds or changes tools, that screen changes first.

Workspaces and documents​

Workspaces, projects, folders, documents, versions, shares, attachments, trash, upload tokens, and search. OpenAPI and HTML documents are also created and updated with create_documents and update_documents. An HTML document takes its raw HTML as content in typePayload.

  • list_workspaces, list_projects, list_documents
  • create_documents, update_documents, move_documents
  • list_versions, restore_versions, search_documents

ERD​

Tables, columns, relationships, enums, table groups, and table arrangement.

  • erd_list_tables, erd_get_table, erd_list_refs, erd_apply_changes, erd_arrange_tables

Diagram​

Nodes, edges, and groups.

  • diagram_list_nodes, diagram_list_edges, diagram_get_node, diagram_apply_changes

Markdown​

  • markdown_generate_document, markdown_append_document

Example request​

Create tables for a blog database: users (id, email, name, created_at), posts (id, user_id, title, content), comments (id, post_id, user_id, content)

The Agent uses AiNecto tools to create the tables and relationships.

AiNecto CLI​

The CLI calls the same tools from your terminal or a script, with no AI Agent involved. Use it for automation. Agents connect through MCP, not the CLI. Requires Node.js 18 or later.

Run once per machine. It signs you in through the browser if needed, checks the connection, and connects Claude Code, Cursor, and Codex. Every session gets the same tools; what you can change follows your AiNecto project permissions.

npx -y ainecto@latest setup

Check it with ainecto status; ainecto doctor explains what is wrong and the command that fixes it. Preview with --dry-run; remove the connections with --undo.

Add repository rules (optional)​

Run from your repository root. It writes the AiNecto working rules (.ainecto/HARNESS.md and a block in AGENTS.md). Add --mcp to also write the project's .mcp.json. Running it again in an older repository tidies its settings.

npx -y ainecto@latest init

Install​

To use the ainecto command directly (scripts, CI):

npm install -g ainecto
ainecto --version

Update with npm install -g ainecto@latest. Without installing, prefix any command with npx -y ainecto@latest.

Sign in​

Opens a browser window once, then keeps the token on this machine.

ainecto auth login
ainecto auth status

Use​

ainecto projects list
ainecto tools list
ainecto tools call list_projects --json
ainecto erd apply-changes -f erd-operations.json --yes

The CLI talks to the server directly, so it uses the plain tool names with no prefix. Run ainecto tools list to see them all.

Sign out​

ainecto auth logout