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_documentscreate_documents,update_documents,move_documentslist_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.
Set up this machine (recommended)
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