# Idx API Orchestration

> FastAPI backend orchestration, MCP infrastructure servers/clients, and community integrations.

- Skill: `gitwalter/idx-api-orchestration` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gitwalter/idx-api-orchestration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gitwalter/idx-api-orchestration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: gitwalter (https://skillmd.com/u/gitwalter)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/gitwalter/idx-api-orchestration

---


# FastAPI Backend & MCP Infrastructure

This skill manages the local API services that connect the Next.js visual frontend with Python CLI backend scripts, coordinates local MCP servers, and integrates with external package managers (npm, pypi, github).

## When to Use
Use this skill when modifying the Next.js API endpoints, building custom MCP servers (like the RAG mcp server), running the workspace email automation, or adding npm/pypi metadata adapters.

## Prerequisites
- Conda environment setup.
- Node.js environment configured (for js-based adapters).

## Process

Follow these procedures to launch API endpoints and test MCP routing.

### Launching the Backend API Server
Start the local FastAPI service on port 8000:
```bash
conda run -p D:\Anaconda\envs\cursor-factory python scripts/api/mcp_api.py
```

### Running MCP client scripts
Search local indices or verify server logs:
```bash
conda run -p D:\Anaconda\envs\cursor-factory python scripts/mcp_infra/search_client.py
```

## Best Practices
- **Graceful Shutdown**: Always handle server SIGINT signals properly to release system ports.
- **Port Reuse**: Check and terminate processes occupying port 8000 before launching the FastAPI script.