Remote MCP
Remote MCP gives your AI assistant access to Aexol's cloud tools: validate
specs, generate code, search your knowledge base, manage documents — all from
your editor's AI chat.
What You Get
| Capability | Tools |
|---|
| Code Generation | Generate artifacts (GraphQL, Prisma, routes, frontend) from Aexol specs |
| AI Import | Turn natural language or documents into Aexol specs |
| Refinement | Iteratively improve generated code or raw Aexol content |
| Knowledge Base | Upload, search, and manage team documents |
| Context | Set default team/project scope for all operations |
Quick Setup
You need two things:
- A team API key — from Studio → Team settings → API Keys
- Your AI tool's MCP config — pick your tool below
Claude Code
claude mcp add --transport http aexol https://api.aexol.ai/mcp \
--header "Authorization: Bearer sk-aexol-team-..."
GitHub Copilot
~/.copilot/mcp-config.json:
{
"mcpServers": {
"aexol": {
"type": "http",
"url": "https://api.aexol.ai/mcp",
"headers": { "Authorization": "Bearer sk-aexol-team-..." }
}
}
}
Cursor / Windsurf / Zed / Continue
Any client that supports HTTP MCP servers can connect. Use:
| Setting | Value |
|---|
| Transport | HTTP |
| URL | https://api.aexol.ai/mcp |
| Header | Authorization: Bearer sk-aexol-team-... |
How It Works
- Your AI assistant connects to the Remote MCP endpoint
- It calls
tools/list to discover available Aexol tools
- It calls
tools/call with the tool it needs (e.g., remote_start_inference)
- Aexol processes the request and returns results directly in your chat
Your assistant can now validate specs, generate code, search docs, and refine
output — all without leaving your editor.
Available Tools
Generation
| Tool | Purpose |
|---|
remote_start_inference | Start artifact generation (GraphQL, Prisma, routes, frontend) |
remote_get_inference_task | Check on or wait for generation results |
remote_list_inference_tasks | List your generation tasks |
remote_cancel_inference_task | Cancel a running task |
remote_refine_inference_artifact | Refine a specific generated artifact |
Import & Refinement
| Tool | Purpose |
|---|
remote_start_from | Generate Aexol from text, documents, or descriptions |
remote_get_from_task | Check on or wait for import results |
remote_refine_aexol_content | Refine raw Aexol content with AI suggestions |
Knowledge Base
| Tool | Purpose |
|---|
remote_ingest_cloud_document | Upload a document to your team's knowledge base |
remote_cloud_search | Search your knowledge base with natural language |
remote_list_cloud_documents | Browse all documents (paginated) |
remote_get_cloud_document | Get a specific document by ID |
remote_update_cloud_document | Edit a document's metadata or content |
remote_delete_cloud_document | Remove a document |
Session
| Tool | Purpose |
|---|
remote_set_context | Set default team/project for this session |
remote_get_context | Show current session context |
remote_clear_context | Reset session defaults |
Troubleshooting
| Problem | Cause | Fix |
|---|
| 401 Unauthorized | Wrong or missing key | Use a team API key (sk-aexol-team-...), not a user key |
| Tool not found | Connection issue | Check your MCP tool's connection status, verify URL |
| Timeout | Long-running task | Use remote_get_inference_task to poll for results |
| No response | Wrong endpoint | URL must be exactly https://api.aexol.ai/mcp |
See Also