================================================================================
  SindByte MCP Server - Paperclip Integration Package
  Version: 1.9.36+
================================================================================

WHAT IS THIS?
-------------
SindByte includes a built-in MCP (Model Context Protocol) server that exposes
hundreds of tools to AI coding agents. This folder contains everything needed to
connect Paperclip-managed agents to your SindByte MCP server.

REQUIREMENTS
------------
1. SindByte must be running (main executable)
2. Paperclip must be installed and running
3. An agent must be created in Paperclip (OpenCode, Claude, or Codex adapter)
4. LM-Studio or another OpenAI-compatible local AI provider (optional but recommended)

MCP SERVER ENDPOINT
-------------------
  URL: http://127.0.0.1:<MCP_PORT>/mcp
  Transport: HTTP JSON-RPC 2.0 (remote MCP)
  Note: Use POST with method "tools/call" for tool invocation
  Tools: Hundreds across FileTools, SystemTools, DataTools, Trading, etc.

QUICK START
-----------
1. Start SindByte (main executable)
2. Copy .mcp.json from this folder into your project directory
3. Commit .mcp.json to git (required for Paperclip worktree isolation)
4. Set worktreeIsolation: false in your Paperclip agent config (recommended)
5. Start your Paperclip agent - it will discover SindByte tools automatically

FILES IN THIS FOLDER
--------------------
  README.txt                          - This file
  SindByte-Paperclip-Setup-Guide.md   - Detailed technical setup guide
  Trading-Firm-Technical-Guide.md     - Architecture guide for AI trading desks
  .mcp.json                           - Sample MCP config (points to localhost MCP)
  setup-mcp.ps1                       - PowerShell script to auto-deploy .mcp.json
  Paperclip-Agent-Config.txt          - Example adapter configuration snippets
  CHANGELOG.md                        - Version history

TROUBLESHOOTING
---------------
  "No tools showing"         -> Check SindByte is running on configured MCP port
  "MCP not connected"        -> Check .mcp.json is in the project directory
  "Config not found"         -> Disable worktree isolation or commit .mcp.json
  "Connection refused"       -> Start SindByte before the Paperclip agent
  "NullReferenceException"   -> GET /mcp returns this (known, harmless). Use POST with JSON-RPC.
  "401 from API provider"    -> LM-Studio may require a token. See setup guide for auth options.

SEE ALSO
--------
  SindByte-Paperclip-Setup-Guide.md  - Full setup, config, and troubleshooting
  Trading-Firm-Technical-Guide.md    - How to build an AI-governed trading desk

================================================================================
