Aexol Quick Reference

Remote MCP (AI Agents)

Remote MCP gives your AI assistant the ability to validate, generate, and refine Aexol code.

Endpoint: https://api.aexol.ai/mcp Auth: Authorization: Bearer sk-aexol-team-... Methods: initialize, ping, tools/list, tools/call

Key Tools

ToolPurpose
remote_start_inferenceGenerate artifacts (GraphQL, Prisma, routes, frontend)
remote_get_inference_taskCheck on running generation tasks
remote_refine_aexol_contentRefine raw Aexol content
remote_start_fromGenerate Aexol from natural language
remote_ingest_cloud_documentUpload docs to knowledge base
remote_cloud_searchSearch team knowledge base
remote_set_contextSet default team/project scope

Full tool catalog: Remote MCP Configuration

Quick Test

# Health check
curl -s -X POST "https://api.aexol.ai/mcp" \
  -H "Authorization: Bearer sk-aexol-team-..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"ping"}'

LSP (IDE Integration)

# Show capabilities
aexol lsp --info

# Start LSP server
aexol lsp --stdio

Editor Configs

Neovim:

require('lspconfig').aexol.setup{
  cmd = { 'aexol', 'lsp', '--stdio' },
  filetypes = { 'aexol' },
}

VS Code: Install from marketplace; already integrated in vscode-extension/.

Emacs, Sublime: See Working with AI & IDEs.

CLI Commands

CommandWhat it does
aexol parse <file>Parse and display AST
aexol validate <file>Validate syntax and semantics
aexol analyze <file>Detailed analysis report
aexol docs <file> [-o out.md]Generate Markdown docs
aexol auth loginAuthenticate
aexol lsp --stdioStart LSP server
aexol updateInstall/update CLI

Full CLI guide: CLI Commands

Programmatic API

import { Parser, Validator } from "@aexol/parser";

const parser = new Parser(source);
const ast = parser.parse();
const result = new Validator(ast).validate();

if (!result.isValid) {
  console.error(result.errors);
}

Full API reference: API Reference

MCP Response Format

// Success
{
  "content": [{ "type": "json", "json": {...} }],
  "isError": false
}

// Error
{
  "content": [{ "type": "text", "text": "Error message" }],
  "isError": true
}

Troubleshooting

ProblemFix
MCP tool not foundRun tools/list to verify available tools
LSP not workingRun aexol lsp --info to verify
Invalid JSON-RPCInclude jsonrpc/method/id fields
401 UnauthorizedUse a team API key (sk-aexol-team-...)

Documentation

TopicLink
Language Reference/docs/aexol/language-reference
Workflows & Recipes/docs/aexol/workflows
Advanced Types/docs/aexol/advanced-types
CLI & Tooling/docs/aexol/cli
API Reference/docs/aexol/api
AI & IDE Integration/working-with-ai-ides
Remote MCP/remote-mcp
Models & Providers/model-providers