squadco-mcp 0.1.0__tar.gz

squadco_mcp-0.1.0/.citekit_output/Payments_Initiate-payment_Initiate_Payment_API_Initiate_cURL_Example_lines_52-63.md

@@ -0,0 +1,12 @@
+  curl --location 'https://sandbox-api.squadco.com/transaction/initiate'   
+  --header 'Authorization: 47M3DMZD'  
+  --header 'Content-Type: application/json'  
+  --data-raw '{  
+    "amount":_ ,  
+    "email":_ ,  
+    "key":_ ,  
+      "currency":"NGN",  
+      "initiate_type": "inline",  
+      "CallBack_URL" : "https://www.linkedin.com/",  
+  }  
+  

squadco_mcp-0.1.0/.citekit_output/Payments_Initiate-payment_Initiate_Payment_API_Initiate_lines_48-50.md

@@ -0,0 +1,3 @@
+Send Request
+
+```

squadco_mcp-0.1.0/.citekit_output/Payments_Initiate-payment_Simulate_Test_Payment_Transfer_API_Simulate_Payment_lines_158-160.md

@@ -0,0 +1,3 @@
+            "data": null  
+}  
+

squadco_mcp-0.1.0/.citekit_output/Payments_test-cards_TestCards_lines_32-38.md

@@ -0,0 +1,4 @@
+![](https://res.cloudinary.com/delflsgq4/image/upload/v1/squad-docs/frontCard?_a=DAJFJtWIZAA0)Copy card number
+![](https://res.cloudinary.com/delflsgq4/image/upload/v1/squad-docs/backCard?_a=DAJFJtWIZAA0)
+[](https://github.com/HabariPay/habaripay.github.io/tree/main/docs/Payments/test-cards.mdx)
+[Previous Squad Payment Modal](https://docs.squadco.com/Payments/squad-payment-modal)[Next Direct API Integration](https://docs.squadco.com/Payments/direct-api-integration)

squadco_mcp-0.1.0/.citekit_output/Transfer-API_transfer-apis_TransferAPI_FundTransfer_Parameters_lines_439-457.md

@@ -0,0 +1,19 @@
+090570       Iyamoye Microfinance Bank  
+090571       Ilaro Poly Microfinance Bank  
+090572       EWT Microfinance Bank  
+090573       Snow MFB  
+090575       First Midas Microfinance Bank  
+090576       Octopus Microfinance Bank  
+090579       Gbede Microfinance Bank  
+090580       Otech Microfinance Bank  
+090583       Stateside Microfinance Bank  
+090574       GOLDMAN MFB  
+090535       Nkpolu-Ust MFB  
+090578       Iwade MFB Ltd  
+090587       Microbiz MFB  
+090588       Orisun MFB  
+090589       Mercury MFB  
+090591       Gabsyn Microfinance Bank Limited  
+090593       Tasued Microfinance Bank  
+090602       Kenechukwu Microfinance Bank  
+090950       Waya Microfinance Bank  

squadco_mcp-0.1.0/.citekit_output/Transfer-API_transfer-apis_TransferAPI_FundTransfer_SampleRequest_lines_458-467.md

@@ -0,0 +1,10 @@
+090598       IBA Microfinance Bank  
+090584       Island Microfinance Bank  
+090600       Ave Maria Microfinance Bank  
+090608       Akpo Microfinance Bank  
+090609       Ummah  Microfinance Bank  
+090610       Amoye Microfinance Bank  
+090612       Medef Microfinance Bank  
+090532       IBOLO Microfinance Bank  
+090581       Banc Corp MFB  
+090614       Flourish MFB  

squadco_mcp-0.1.0/.citekit_output/Transfer-API_transfer-apis_TransferAPI_FundTransfer_lines_414-497.md

@@ -0,0 +1,84 @@
+090544       Aspire Microfinance Bank  
+090545       Abulesoro Microfinance Bank  
+090546       Ijebu-Ife Microfinance Bank  
+090547       Rockshield Microfinance Bank  
+090548       Ally Microfinance Bank  
+090549       KC Microfinance Bank  
+090550       Green Energy Microfinance Bank  
+090551       FairMoney Microfinance Bank  
+090553       Consistent Trust Microfinance Bank  
+090554       Kayvee Microfinance Bank  
+090555       BishopGate Microfinance Bank  
+090556       Egwafin Microfinance Bank  
+090557       Lifegate Microfinance Bank  
+090558       Shongom Microfinance Bank  
+090559       Shield Microfinance Bank  
+090560       Tanadi Microfinance Bank  
+090561       Akuchuckwu Microfinance Bank  
+090562       Cedar Microfinance Bank  
+090563       Balera Microfinance Bank  
+090564       Supreme Microfinance Bank  
+090565       Oke-Aro Oredegbe Microfinance Bank  
+090566       Okuku Microfinance Bank  
+090567       Orokam Microfinance Bank  
+090568       Broadview Microfinance Bank  
+090569       Qube Microfinance Bank  
+090570       Iyamoye Microfinance Bank  
+090571       Ilaro Poly Microfinance Bank  
+090572       EWT Microfinance Bank  
+090573       Snow MFB  
+090575       First Midas Microfinance Bank  
+090576       Octopus Microfinance Bank  
+090579       Gbede Microfinance Bank  
+090580       Otech Microfinance Bank  
+090583       Stateside Microfinance Bank  
+090574       GOLDMAN MFB  
+090535       Nkpolu-Ust MFB  
+090578       Iwade MFB Ltd  
+090587       Microbiz MFB  
+090588       Orisun MFB  
+090589       Mercury MFB  
+090591       Gabsyn Microfinance Bank Limited  
+090593       Tasued Microfinance Bank  
+090602       Kenechukwu Microfinance Bank  
+090950       Waya Microfinance Bank  
+090598       IBA Microfinance Bank  
+090584       Island Microfinance Bank  
+090600       Ave Maria Microfinance Bank  
+090608       Akpo Microfinance Bank  
+090609       Ummah  Microfinance Bank  
+090610       Amoye Microfinance Bank  
+090612       Medef Microfinance Bank  
+090532       IBOLO Microfinance Bank  
+090581       Banc Corp MFB  
+090614       Flourish MFB  
+090615       Beststar MFB  
+090616       Rayyan MFB  
+090603       Macrod MFB  
+090634       Cashbridge Microfinance Bank  
+090620       Iyin Ekiti MFB  
+090611       Creditville MFB  
+090623       MAB Allianz MFB  
+100001       FET  
+100002       Paga  
+100003       Parkway-ReadyCash  
+100004       Opay Digital Services LTD  
+100005       Cellulant  
+100006       eTranzact  
+100007       Stanbic IBTC @ease wallet  
+100008       Ecobank Xpress Account  
+100009       GTMobile  
+100010       TeasyMobile  
+100011       Mkudi  
+100012       VTNetworks  
+100013       AccessMobile  
+100014       FBNMobile  
+100036       Kegow (Chamsmobile)  
+100016       FortisMobile  
+100017       Hedonmark  
+100018       ZenithMobile  
+100019       Fidelity Mobile  
+100020       MoneyBox  
+100021       Eartholeum  
+100022       GoMoney  
+100023       TagPay  

squadco_mcp-0.1.0/.citekit_output/Transfer-API_transfer-apis_TransferAPI_lines_29-36.md

@@ -0,0 +1,8 @@
+**Authorization** keys are to be passed via Headers as a Bearer token.
+**Example:** Authorization: Bearer sandbox_sk_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f
+### Account Lookup[​](https://docs.squadco.com/Transfer-API/transfer-apis/#account-lookup "Direct link to Account Lookup")
+This API allows you lookup/confirm the account name of the recipient you intend to credit. This should be done before initiating the transfer.
+POST
+https://sandbox-api-d.squadco.com/payout/account/lookup
+### This API allows you confirm Account Name to be transferred to.
+#### Parameters

squadco_mcp-0.1.0/.citekit_output/index_GettingStarted_BeforeYouBegin_lines_35-39.md

@@ -0,0 +1,3 @@
+  * [Getting Started](https://docs.squadco.com/#getting-started)
+
+

squadco_mcp-0.1.0/.citekit_output/index_GettingStarted_lines_25-33.md

@@ -0,0 +1,9 @@
+#### Before You Begin[​](https://docs.squadco.com/#before-you-begin "Direct link to Before You Begin")
+  1. Create a free Squad account [Here](https://dashboard.squadco.com/sign-up) (for Test, create a [Sandbox Account](https://sandbox.squadco.com/sign-up))
+  2. Integrate Squad payment gateway.
+  3. Test your integration using secret Keys on your Dashboard.
+  4. Initiate payment and proceed to the checkout URL to complete payment.
+
+
+![](https://res.cloudinary.com/delflsgq4/image/upload/v1/squad-docs/demo?_a=DAJFJtWIZAA0)
+[](https://github.com/HabariPay/habaripay.github.io/tree/main/docs/Home.mdx)

squadco_mcp-0.1.0/.citekit_output/index_WelcomeToSquadDocumentation_lines_21-23.md

@@ -0,0 +1,3 @@
+# Welcome to the Squad Documentation
+##### We're excited to introduce a payment feature that enables you to make and receive payments from any location across the globe! This means that, wherever your customers are, they will be able to make payments for your products and services successfully. This way, you can more reliably deliver value to your customers.[​](https://docs.squadco.com/#were-excited-to-introduce-a-payment-feature-that-enables-you-to-make-and-receive-payments-from-any-location-across-the-globe-this-means-that-wherever-your-customers-are-they-will-be-able-to-make-payments-for-your-products-and-services-successfully-this-way-you-can-more-reliably-deliver-value-to-your-customers "Direct link to We're excited to introduce a payment feature that enables you to make and receive payments from any location across the globe! This means that, wherever your customers are, they will be able to make payments for your products and services successfully. This way, you can more reliably deliver value to your customers.")
+### Getting Started[​](https://docs.squadco.com/#getting-started "Direct link to Getting Started")

squadco_mcp-0.1.0/.citekit_output/webhook-direct-url_webhook-and-direct-url_WebhookRedirectURL_SampleWebhookCard_lines_68-89.md

@@ -0,0 +1,22 @@
+    "email": "williamudousoro@gmail.com",  
+    "merchant_id": "SBBWRX1Z3S",  
+    "currency": "NGN",  
+    "transaction_type": "Card",  
+    "merchant_amount": 10000,  
+    "created_at": "2025-08-24T15:26:38.994",  
+    "meta": {  
+      "location": "gtbank test test"  
+    },  
+    "payment_information": {  
+      "payment_type": "card",  
+      "pan": "424242******4242|0825",  
+      "card_type": "verve"  
+    },  
+    "is_recurring": false  
+  }  
+}  
+
+```
+
+### Sample Webhook for Transfers[​](https://docs.squadco.com/webhook-direct-url/webhook-and-direct-url/#sample-webhook-for-transfers "Direct link to Sample Webhook for Transfers")
+

squadco_mcp-0.1.0/.citekit_output/webhook-direct-url_webhook-and-direct-url_WebhookRedirectURL_WebhookIsPostRequest_Parameters_lines_52-65.md

@@ -0,0 +1,14 @@
+JSON
+application/json
+  
+
+Sample POST request to be sent via webhook upon successful transaction
+### Sample Webhook for Card Transactions[​](https://docs.squadco.com/webhook-direct-url/webhook-and-direct-url/#sample-webhook-for-card-transactions "Direct link to Sample Webhook for Card Transactions")
+
+```
+{  
+  "Event": "charge_successful",  
+  "TransactionRef": "SQTEST6389164239897900003",  
+  "Body": {  
+    "amount": 10000,  
+    "transaction_ref": "SQTEST6389164239897900003",  

squadco_mcp-0.1.0/.citekit_output/webhook-direct-url_webhook-and-direct-url_WebhookRedirectURL_WebhookValidation_lines_47-48.md

@@ -0,0 +1,2 @@
+##### Header
+x-squad-encrypted-body*

squadco_mcp-0.1.0/.citekit_output/webhook-direct-url_webhook-and-direct-url_WebhookRedirectURL_lines_28-44.md

@@ -0,0 +1,17 @@
+This can be set up on your Squad Dashboard by specifying a URL we would send POST requests to whenever a successful transaction occurs.
+To process notifications, you need to:
+Paste your redirect and **Callback/Webhook URL** in the space provided on your dashboard by following the steps below:
+  * Login to your Squad dashboard.
+  * Go to Profile > API & Webhook.
+  * In the Webhook URL field, enter your Notification URL.
+  * In the redirect URL field, enter your redirect URL- and on completion of payment, the customer will be redirected to the URL with the transaction reference passed as a query param.
+  * Enter a redirect URL for your customers to be redirected after they complete payment.
+
+
+NB:The Redirect URL is optional.
+**KINDLY ENSURE YOU HAVE A TRANSACTION REFERENCE CHECKER WHEN IMPLEMENTING WEBHOOKS TO AVOID GIVING DOUBLE VALUE ON TRANSACTIONS.**
+Sending IP: 18.133.63.109
+### Webhook Validation[​](https://docs.squadco.com/webhook-direct-url/webhook-and-direct-url/#webhook-validation "Direct link to Webhook Validation")
+To configure webhook notifications: go to **_dashboard > profile > Api & Webhooks._**
+POST
+https://api.gitbook.com/v1/users

squadco_mcp-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+venv/
+.env
+dist/
+*.pyc
+__pycache__/
+.pytest_cache/
+*.egg-info/

squadco_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: squadco-mcp
+Version: 0.1.0
+Summary: SquadCo API documentation as an MCP server
+Requires-Python: >=3.10
+Requires-Dist: citekit>=0.1.0
+Requires-Dist: mcp[cli]>=1.2.0
+Description-Content-Type: text/markdown
+
+# SquadCo API Docs MCP Server
+
+> **Disclaimer**: This is a community-driven project and is **not affiliated with or endorsed by SquadCo**. It is built by developers, for developers, using the official public SquadCo documentation.
+
+The SquadCo MCP Server provides your AI coding assistant (Claude, Cursor, Windsurf, etc.) with direct, structured access to the full SquadCo API documentation. 
+
+Stop switching between your editor and the browser. Get precise API specs, validation logic, and code samples for SquadCo integrations directly in your chat.
+
+---
+
+## Key Features
+
+- **Direct Knowledge**: Instant access to documentation for Payments, Transfers, Virtual Accounts, VAS, and Webhooks.
+- **Accurate Specs**: Returns the exact technical markdown sections—no fuzzy hallucinations.
+- **Developer Ready**: Full details on Sandbox environments, test cards, and security validation.
+- **No Clone Needed**: Run directly using `uvx` or `pipx`.
+
+---
+
+## Capabilities
+
+The MCP server covers the entire SquadCo ecosystem:
+
+### 1. Payments and Collections
+*   **Checkout Options**: Integration guides for the Squad Payment Modal (Inline), Redirect flows, and mobile-ready implementations.
+*   **Direct API**: Technical specs for server-to-server payment initiation and transaction verification.
+*   **Alternative Methods**: Documentation for POS Payment, Direct Debit, and E-commerce plugins (WooCommerce).
+*   **Testing**: A comprehensive list of test card numbers, expiry dates, and CVVs for sandbox testing.
+
+### 2. Transfers and Payouts
+*   **Fund Transfers**: How to move funds from your Squad Wallet to any bank account in Nigeria.
+*   **Account Lookup**: recipient name verification logic to ensure transaction accuracy.
+*   **Wallet Management**: Checking ledger balances and transaction history.
+*   **Bank Codes**: A complete, searchable list of all supported bank and microfinance codes.
+
+### 3. Virtual Accounts
+*   **Account Generation**: Creating dedicated virtual accounts for customers to receive automated bank transfers.
+*   **Dynamic V2**: Advanced specifications for high-frequency, dynamic account creation and management.
+*   **Metadata**: Attaching custom data to accounts for easier reconciliation.
+
+### 4. Value Added Services (VAS)
+*   **Airtime and Data**: API specs for selling mobile airtime and data bundles.
+*   **Bills Payment**: Integration for electricity bills and other utility services.
+*   **SMS Services**: Managing SMS buckets and automated messaging.
+
+### 5. Operations and Security
+*   **Webhooks**: Step-by-step setup for POST notifications, IP filtering, and signature verification.
+*   **Security**: Technical guides for HMAC-SHA512 validation and AES-256 encryption/decryption.
+*   **Management**: Detailed flows for Refunds, Disputes, and Chargebacks.
+
+### 6. Sandbox and Testing
+*   **Environment Setup**: Detailed information on using the `sandbox-api.squadco.com` endpoints.
+*   **Test Assets**: A full database of test card numbers, CVVs, and standard OTP codes for simulating successful and failed payments.
+*   **Transfer Simulation**: Specific API flows for simulating incoming bank transfers to virtual accounts in a test environment.
+
+---
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `search_docs` | The main entry point. Search for any SquadCo feature (e.g., "AES encryption"). |
+| `list_docs` | Browse all available API documentation files. |
+| `get_doc_structure` | View the structural map of a specific document to find precise sections. |
+| `resolve_section` | Fetch the full technical content, URLs, and code samples for a section. |
+
+---
+
+## Client Configuration Guide
+
+Depending on your preferred AI assistant, the configuration process varies slightly. Below are the specific setup steps for the most common MCP-compatible clients.
+
+### 1. Claude Desktop
+Claude Desktop looks for a central configuration file to load MCP servers.
+
+**Config File Locations:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**Setup:** Open the file and add the `squadco-docs` entry to the `mcpServers` object.
+**Note:** In Claude Desktop, go to Settings > Developer > Edit Config to open this file directly.
+
+### 2. Cursor
+Cursor provides a native UI for managing MCP servers, making it one of the easiest to configure.
+
+1. Open Cursor Settings (Gear icon in the top right).
+2. Navigate to Features (or Tools & Integrations).
+3. Scroll down to MCP Servers and click + Add New MCP Server.
+4. Set the type to `command` and paste the following:
+   - **Name**: `squadco-docs`
+   - **Command**: `uvx squadco-mcp` (or the absolute path to uvx).
+
+### 3. Windsurf (by Codeium)
+Windsurf uses a `settings.json` file to manage its Cascade AI capabilities.
+
+**Config File Locations:**
+- **macOS**: `~/Library/Application Support/Windsurf/User/settings.json`
+- **Windows**: `%APPDATA%\Windsurf\User\settings.json`
+
+**Configuration:** Add the server under the `mcpServers` key. Windsurf also supports a simplified `serverUrl` if you are hosting the MCP server remotely.
+
+### 4. Visual Studio Code
+For standard VS Code users, MCP support is typically handled via the MCP Client extension or workspace-specific configurations.
+
+- **Workspace Config**: Create a `.vscode/mcp.json` file in your project root. This allows you to share the MCP server configuration with teammates who also use the repository.
+- **Global Config**: Some extensions allow a global `mcp.json` in your user profile for tools you want available across all projects.
+
+### 5. Claude Code (CLI)
+For users of the Claude CLI, you can add the server using the built-in add command:
+`claude mcp add squadco-mcp -- uvx squadco-mcp`
+
+---
+
+## MCP Configuration Reference
+
+| Client | MCP Integration Method | squadco-mcp Configuration |
+|---|---|---|
+| Claude Desktop | JSON-RPC over stdio | Add to `mcpServers` in `claude_desktop_config.json` |
+| Cursor | Native MCP UI | Use `uvx squadco-mcp` as the command |
+| Windsurf | Cascade MCP | Add to `mcpServers` in `settings.json` |
+| VS Code | Workspace MCP | Add to `.vscode/mcp.json` |
+| Claude Code | CLI MCP Manager | Run `claude mcp add squadco-mcp -- uvx squadco-mcp` |
+
+---
+
+## Troubleshooting Tips
+
+- **Absolute Paths**: Some clients (especially Claude Desktop) have limited environment path access. If `uvx` or `pipx` isn't found, use the absolute path to the executable (e.g., `/usr/local/bin/uvx`).
+- **Restart Required**: Most desktop clients require a full restart (not just closing the window) to pick up changes made directly to JSON configuration files.
+- **Logs**: If the server fails to connect, check the developer console (usually Ctrl+Shift+I or Cmd+Option+I) for JSON-RPC connection errors.
+
+---
+
+## Technical Details
+
+The SquadCo MCP Server uses [CiteKit](https://abdushakurob.github.io/citekit) to provide high-fidelity documentation access to AI agents.
+
+Unlike standard RAG (Retrieval-Augmented Generation) which uses vector-based similarity, this server employs a structural mapping approach:
+
+- **Pre-computed Mapping**: Documentation is analyzed during ingestion to create a structural index of all API endpoints, parameters, and code blocks.
+- **Deterministic Resolution**: The AI assistant identifies the specific node it needs from the map and resolves the content locally from the bundled markdown files.
+- **Precision Context**: By resolving exact sections rather than chunked text, the server ensures the AI receives clean, relevant context without noise.
+
+**Stack:**
+- **Core Engine**: [CiteKit](https://abdushakurob.github.io/citekit) (by [@abdushakurob](https://github.com/abdushakurob))
+- **Scraper**: [crawl4ai](https://github.com/unclecode/crawl4ai)
+- **Protocol**: [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
+
+---

squadco_mcp-0.1.0/README.md

@@ -0,0 +1,149 @@
+# SquadCo API Docs MCP Server
+
+> **Disclaimer**: This is a community-driven project and is **not affiliated with or endorsed by SquadCo**. It is built by developers, for developers, using the official public SquadCo documentation.
+
+The SquadCo MCP Server provides your AI coding assistant (Claude, Cursor, Windsurf, etc.) with direct, structured access to the full SquadCo API documentation. 
+
+Stop switching between your editor and the browser. Get precise API specs, validation logic, and code samples for SquadCo integrations directly in your chat.
+
+---
+
+## Key Features
+
+- **Direct Knowledge**: Instant access to documentation for Payments, Transfers, Virtual Accounts, VAS, and Webhooks.
+- **Accurate Specs**: Returns the exact technical markdown sections—no fuzzy hallucinations.
+- **Developer Ready**: Full details on Sandbox environments, test cards, and security validation.
+- **No Clone Needed**: Run directly using `uvx` or `pipx`.
+
+---
+
+## Capabilities
+
+The MCP server covers the entire SquadCo ecosystem:
+
+### 1. Payments and Collections
+*   **Checkout Options**: Integration guides for the Squad Payment Modal (Inline), Redirect flows, and mobile-ready implementations.
+*   **Direct API**: Technical specs for server-to-server payment initiation and transaction verification.
+*   **Alternative Methods**: Documentation for POS Payment, Direct Debit, and E-commerce plugins (WooCommerce).
+*   **Testing**: A comprehensive list of test card numbers, expiry dates, and CVVs for sandbox testing.
+
+### 2. Transfers and Payouts
+*   **Fund Transfers**: How to move funds from your Squad Wallet to any bank account in Nigeria.
+*   **Account Lookup**: recipient name verification logic to ensure transaction accuracy.
+*   **Wallet Management**: Checking ledger balances and transaction history.
+*   **Bank Codes**: A complete, searchable list of all supported bank and microfinance codes.
+
+### 3. Virtual Accounts
+*   **Account Generation**: Creating dedicated virtual accounts for customers to receive automated bank transfers.
+*   **Dynamic V2**: Advanced specifications for high-frequency, dynamic account creation and management.
+*   **Metadata**: Attaching custom data to accounts for easier reconciliation.
+
+### 4. Value Added Services (VAS)
+*   **Airtime and Data**: API specs for selling mobile airtime and data bundles.
+*   **Bills Payment**: Integration for electricity bills and other utility services.
+*   **SMS Services**: Managing SMS buckets and automated messaging.
+
+### 5. Operations and Security
+*   **Webhooks**: Step-by-step setup for POST notifications, IP filtering, and signature verification.
+*   **Security**: Technical guides for HMAC-SHA512 validation and AES-256 encryption/decryption.
+*   **Management**: Detailed flows for Refunds, Disputes, and Chargebacks.
+
+### 6. Sandbox and Testing
+*   **Environment Setup**: Detailed information on using the `sandbox-api.squadco.com` endpoints.
+*   **Test Assets**: A full database of test card numbers, CVVs, and standard OTP codes for simulating successful and failed payments.
+*   **Transfer Simulation**: Specific API flows for simulating incoming bank transfers to virtual accounts in a test environment.
+
+---
+
+## Tools
+
+| Tool | Purpose |
+|---|---|
+| `search_docs` | The main entry point. Search for any SquadCo feature (e.g., "AES encryption"). |
+| `list_docs` | Browse all available API documentation files. |
+| `get_doc_structure` | View the structural map of a specific document to find precise sections. |
+| `resolve_section` | Fetch the full technical content, URLs, and code samples for a section. |
+
+---
+
+## Client Configuration Guide
+
+Depending on your preferred AI assistant, the configuration process varies slightly. Below are the specific setup steps for the most common MCP-compatible clients.
+
+### 1. Claude Desktop
+Claude Desktop looks for a central configuration file to load MCP servers.
+
+**Config File Locations:**
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+**Setup:** Open the file and add the `squadco-docs` entry to the `mcpServers` object.
+**Note:** In Claude Desktop, go to Settings > Developer > Edit Config to open this file directly.
+
+### 2. Cursor
+Cursor provides a native UI for managing MCP servers, making it one of the easiest to configure.
+
+1. Open Cursor Settings (Gear icon in the top right).
+2. Navigate to Features (or Tools & Integrations).
+3. Scroll down to MCP Servers and click + Add New MCP Server.
+4. Set the type to `command` and paste the following:
+   - **Name**: `squadco-docs`
+   - **Command**: `uvx squadco-mcp` (or the absolute path to uvx).
+
+### 3. Windsurf (by Codeium)
+Windsurf uses a `settings.json` file to manage its Cascade AI capabilities.
+
+**Config File Locations:**
+- **macOS**: `~/Library/Application Support/Windsurf/User/settings.json`
+- **Windows**: `%APPDATA%\Windsurf\User\settings.json`
+
+**Configuration:** Add the server under the `mcpServers` key. Windsurf also supports a simplified `serverUrl` if you are hosting the MCP server remotely.
+
+### 4. Visual Studio Code
+For standard VS Code users, MCP support is typically handled via the MCP Client extension or workspace-specific configurations.
+
+- **Workspace Config**: Create a `.vscode/mcp.json` file in your project root. This allows you to share the MCP server configuration with teammates who also use the repository.
+- **Global Config**: Some extensions allow a global `mcp.json` in your user profile for tools you want available across all projects.
+
+### 5. Claude Code (CLI)
+For users of the Claude CLI, you can add the server using the built-in add command:
+`claude mcp add squadco-mcp -- uvx squadco-mcp`
+
+---
+
+## MCP Configuration Reference
+
+| Client | MCP Integration Method | squadco-mcp Configuration |
+|---|---|---|
+| Claude Desktop | JSON-RPC over stdio | Add to `mcpServers` in `claude_desktop_config.json` |
+| Cursor | Native MCP UI | Use `uvx squadco-mcp` as the command |
+| Windsurf | Cascade MCP | Add to `mcpServers` in `settings.json` |
+| VS Code | Workspace MCP | Add to `.vscode/mcp.json` |
+| Claude Code | CLI MCP Manager | Run `claude mcp add squadco-mcp -- uvx squadco-mcp` |
+
+---
+
+## Troubleshooting Tips
+
+- **Absolute Paths**: Some clients (especially Claude Desktop) have limited environment path access. If `uvx` or `pipx` isn't found, use the absolute path to the executable (e.g., `/usr/local/bin/uvx`).
+- **Restart Required**: Most desktop clients require a full restart (not just closing the window) to pick up changes made directly to JSON configuration files.
+- **Logs**: If the server fails to connect, check the developer console (usually Ctrl+Shift+I or Cmd+Option+I) for JSON-RPC connection errors.
+
+---
+
+## Technical Details
+
+The SquadCo MCP Server uses [CiteKit](https://abdushakurob.github.io/citekit) to provide high-fidelity documentation access to AI agents.
+
+Unlike standard RAG (Retrieval-Augmented Generation) which uses vector-based similarity, this server employs a structural mapping approach:
+
+- **Pre-computed Mapping**: Documentation is analyzed during ingestion to create a structural index of all API endpoints, parameters, and code blocks.
+- **Deterministic Resolution**: The AI assistant identifies the specific node it needs from the map and resolves the content locally from the bundled markdown files.
+- **Precision Context**: By resolving exact sections rather than chunked text, the server ensures the AI receives clean, relevant context without noise.
+
+**Stack:**
+- **Core Engine**: [CiteKit](https://abdushakurob.github.io/citekit) (by [@abdushakurob](https://github.com/abdushakurob))
+- **Scraper**: [crawl4ai](https://github.com/unclecode/crawl4ai)
+- **Protocol**: [Model Context Protocol (MCP)](https://modelcontextprotocol.io/)
+
+---

squadco_mcp-0.1.0/crawl.py

@@ -0,0 +1,50 @@
+import asyncio
+import os
+from crawl4ai import AsyncWebCrawler, CrawlerRunConfig
+from crawl4ai.deep_crawling import BFSDeepCrawlStrategy
+
+async def crawl_squadco():
+    print("Starting crawl of SquadCo docs...")
+    os.makedirs("docs", exist_ok=True)
+
+    config = CrawlerRunConfig(
+        deep_crawl_strategy=BFSDeepCrawlStrategy(
+            max_depth=3,
+            include_external=False,
+            max_pages=100,
+        ),
+        verbose=True
+    )
+
+    async with AsyncWebCrawler() as crawler:
+        results = await crawler.arun(
+            url="https://docs.squadco.com",
+            config=config
+        )
+
+        print(f"\nCrawl complete! Found {len(results)} pages.")
+
+        for i, result in enumerate(results, 1):
+            if not result.success:
+                print(f"[{i}] Skipped (failed): {result.url}")
+                continue
+
+            slug = (
+                result.url
+                .replace("https://docs.squadco.com/", "")
+                .strip("/")
+                .replace("/", "_")
+                or "index"
+            )
+            filepath = f"docs/{slug}.md"
+
+            with open(filepath, "w", encoding="utf-8") as f:
+                f.write(f"# Source: {result.url}\n\n")
+                f.write(result.markdown or "")
+
+            print(f"[{i}/{len(results)}] Saved: {filepath}")
+
+    print("\nDone. All docs saved to 'docs/' directory.")
+
+if __name__ == "__main__":
+    asyncio.run(crawl_squadco())

squadco_mcp-0.1.0/ingest.py

@@ -0,0 +1,32 @@
+import asyncio
+import os
+from citekit import CiteKitClient
+from citekit.mapper.gemini import GeminiMapper
+
+mapper = GeminiMapper(model="gemini-2.5-flash", api_key=os.environ.get("GEMINI_API_KEY"))
+client = CiteKitClient(mapper=mapper)
+
+async def ingest_all():
+    docs_dir = "docs"
+    files = [f for f in os.listdir(docs_dir) if f.endswith(".md")]
+    
+    print(f"Found {len(files)} files to ingest...\n")
+
+    for i, filename in enumerate(files, 1):
+        filepath = os.path.join(docs_dir, filename)
+        resource_id = filename.replace(".md", "")
+        
+        print(f"[{i}/{len(files)}] Ingesting: {resource_id}")
+        
+        try:
+            resource_map = await client.ingest(
+                resource_path=filepath,
+                resource_type="text",
+                resource_id=resource_id
+            )
+            print(f"  ✓ {len(resource_map.nodes)} nodes found\n")
+        except Exception as e:
+            print(f"  ✗ Failed: {e}\n")
+
+if __name__ == "__main__":
+    asyncio.run(ingest_all())