> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebyoulous.space/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP overview

> Drive your Nebyoulous workspace from Claude, Cursor, VS Code, or any MCP client.

Nebyoulous speaks the [Model Context Protocol](https://modelcontextprotocol.io/).
Connect an AI assistant and it can list your integration sets, build rigs,
recommend and start stacks, read frame QA results, and draft posts, all as you.

## Two ways to connect

> **[Hosted server](/mcp/remote)**
>
> `https://api.nebyoulous.space/mcp` over Streamable HTTP. Nothing to install.
> You sign in with OAuth in the browser. Start here.

> **[CLI server](/mcp/local)**
>
> `nebyoulous mcp:serve` over stdio. Adds local tools that read your disks:
> scan a card, plan and run a sync.

| | Hosted server | CLI server |
| - | - | - |
| Transport | Streamable HTTP | stdio |
| Install | None | The `nebyoulous` CLI |
| Sign-in | OAuth in the browser, on first use | `nebyoulous login` |
| Workspace tools | All [hosted tools](/mcp/tools) | The same hosted tools, proxied |
| Local file tools | No | [Yes](/mcp/tools#local-tools-cli-server-only) |
| Works in Claude.ai and Claude Desktop connectors | Yes | Claude Desktop only, as a local server |

Use the hosted server unless your assistant needs to read files on your
machine. You can add both; tool names don't collide, but the CLI server
already includes every hosted tool.

## What an assistant can do

> **Organize frames**
>
> "Create an integration set called *Rosette 2026-04-20*." "What's in my M31
> set, by folder?" "Delete the `flats-old` folder from that set."

> **Record gear**
>
> "Add my RedCat 51, ASI2600MC, and AM5 as gear, then make a rig called
> *Travel* from them and link it to the Rosette set."

> **Stack**
>
> "Recommend a stack config for the Rosette set, then start it." "Is the
> stack done? Give me the master download link."

> **Check frames**
>
> "Run frame QA on `lights-300s` and tell me which frames were rejected and
> why."

> **Publish**
>
> "Look up NGC 2237 in the catalog and draft a post for it linked to the
> Rosette set."

## Safety

* **Every call acts as you.** Identity comes from your token, never from a tool
  argument, so an assistant can only read and change your own data.
* **Destructive tools are marked.** Tools that delete or cancel carry the MCP
  `destructiveHint`, and read-only tools carry `readOnlyHint`. Claude Code,
  Cursor, and other hosts use these to ask you before a destructive call runs.
* **Connections expire.** When you approve a hosted connection you choose how
  long it stays signed in: 7, 30, or 90 days. To disconnect sooner, remove the
  server from your client.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.