README: one definition, one quickstart, inline demo video, lighter first screen

.gitattributes

@@ -13,12 +13,12 @@ docs/**             linguist-documentation
 content/**          linguist-documentation
 *.md                linguist-documentation
 *.mdx               linguist-documentation
-ROADMAP.md          linguist-documentation
+docs/ROADMAP.md          linguist-documentation
 CHANGELOG.md        linguist-documentation
-SUPPORT.md          linguist-documentation
-CONTRIBUTING.md     linguist-documentation
-SECURITY.md         linguist-documentation
-CODE_OF_CONDUCT.md  linguist-documentation
+.github/SUPPORT.md          linguist-documentation
+.github/CONTRIBUTING.md     linguist-documentation
+.github/SECURITY.md         linguist-documentation
+.github/CODE_OF_CONDUCT.md  linguist-documentation
 
 # Lockfiles and large generated artefacts shouldn't pollute language stats.
 package-lock.json   linguist-generated

.github/CODEOWNERS

@@ -21,6 +21,6 @@
 # Documentation
 /docs/                  @keysersoft
 /README.md              @keysersoft
-/CONTRIBUTING.md        @keysersoft
-/SECURITY.md            @keysersoft
-/ROADMAP.md             @keysersoft
+/.github/CONTRIBUTING.md        @keysersoft
+/.github/SECURITY.md            @keysersoft
+/docs/ROADMAP.md             @keysersoft

CONTRIBUTING.md → .github/CONTRIBUTING.md

@@ -20,12 +20,12 @@ This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.
 
 ## License
 
-AnythingMCP is open source under the [GNU Affero General Public License v3](LICENSE) (AGPL-3.0-only). Code under `ee/` directories is licensed separately under the [AnythingMCP Commercial License](packages/backend/src/ee/LICENSE). See the [License FAQ](docs/license-faq.md) for a plain-language explanation.
+AnythingMCP is open source under the [GNU Affero General Public License v3](../LICENSE) (AGPL-3.0-only). Code under `ee/` directories is licensed separately under the [AnythingMCP Commercial License](../packages/backend/src/ee/LICENSE). See the [License FAQ](../docs/license-faq.md) for a plain-language explanation.
 
 ### Contributor License Agreement (CLA)
 
 Before we can merge your first pull request, you must sign our
-[Contributor License Agreement](CLA.md). An automated check on your PR
+[Contributor License Agreement](../CLA.md). An automated check on your PR
 will ask you to sign by posting a comment — it takes one click and
 only needs to be done once.
 
@@ -40,10 +40,10 @@ We use AI assistants (Claude Code, GitHub Copilot, etc.) in our own development
 
 - You take responsibility for the code you submit — review every line before opening a PR.
 - The catalog test suite (`npm test`) must pass.
-- Adapter JSON must validate against [`docs/tool-definition.md`](docs/tool-definition.md).
+- Adapter JSON must validate against [`docs/tool-definition.md`](../docs/tool-definition.md).
 - Don't paste AI output blindly into the PR description; write the *why* in your own words.
 
-We will not refuse a PR because it was AI-assisted, and we will not single it out either. See [AUTHORS.md](AUTHORS.md) for how we use AI ourselves.
+We will not refuse a PR because it was AI-assisted, and we will not single it out either. See [AUTHORS.md](../docs/AUTHORS.md) for how we use AI ourselves.
 
 ## Getting Started
 
@@ -139,7 +139,7 @@ An adapter is one JSON file; the rest is generated and checked.
 
 1. Write `packages/backend/src/adapters/<region>/<slug>.json`. Filename must
    equal `slug`; prefix every tool `<slug_with_underscores>_`; see
-   [docs/tool-definition.md](docs/tool-definition.md) for the envelope.
+   [docs/tool-definition.md](../docs/tool-definition.md) for the envelope.
    To start from a valid skeleton, run
    `npm run adapter:new -- <slug> --region <region> --auth <type>`. It refuses
    to overwrite an existing adapter unless you pass `--force`, and every spot

.github/ISSUE_TEMPLATE/config.yml

@@ -7,7 +7,7 @@ contact_links:
     url: https://anythingmcp.com
     about: Setup guides for every adapter and every AI client, in seven languages.
   - name: 🔐 Security vulnerabilities
-    url: https://github.com/HelpCode-ai/anythingmcp/blob/main/SECURITY.md
+    url: https://github.com/HelpCode-ai/anythingmcp/blob/main/.github/SECURITY.md
     about: Please do NOT open a public issue. Follow the security disclosure policy.
   - name: 💼 Commercial licensing & support
     url: mailto:info@helpcode.ai

SECURITY.md → .github/SECURITY.md

@@ -62,7 +62,7 @@ Update the value in `.env` and restart: `docker compose up -d`. Existing session
 
 `ENCRYPTION_KEY` encrypts connector credentials (API keys, OAuth tokens, database passwords) at rest. Rotating it requires re-encrypting every stored secret, because the existing ciphertext was sealed with the old key.
 
-Until a built-in rotation command ships (tracked in [ROADMAP.md](ROADMAP.md)), the safe procedure is:
+Until a built-in rotation command ships (tracked in [ROADMAP.md](../docs/ROADMAP.md)), the safe procedure is:
 
 1. **Take a database backup** — `docker compose exec postgres pg_dump -U amcp anythingmcp > backup-pre-rotation.sql`.
 2. **Export connector configs** — from the Admin UI, export each connector to JSON (this captures the *decrypted* credentials in transit; keep the export file in a secure location and delete it after step 5).

SUPPORT.md → .github/SUPPORT.md

@@ -14,12 +14,12 @@ The fastest answers usually come from other users. Before opening an issue, chec
 
 ## Documentation
 
-- **[README](README.md)** — overview and quick start
+- **[README](../README.md)** — overview and quick start
 - **[anythingmcp.com](https://anythingmcp.com)** — website with 150+ guides for individual adapters and AI clients (English / German / Italian)
-- **[Deployment Guide](docs/deployment.md)** — production self-hosting
-- **[API Reference](docs/api-reference.md)** — full REST API
-- **[Tool Definition Format](docs/tool-definition.md)** — how adapter JSON files are structured
-- **[License FAQ](docs/license-faq.md)** — what the AGPL-3.0 license means in practice
+- **[Deployment Guide](../docs/deployment.md)** — production self-hosting
+- **[API Reference](../docs/api-reference.md)** — full REST API
+- **[Tool Definition Format](../docs/tool-definition.md)** — how adapter JSON files are structured
+- **[License FAQ](../docs/license-faq.md)** — what the AGPL-3.0 license means in practice
 
 ## Bug reports
 

.github/repo-about.txt

@@ -1 +1 @@
-Turn any REST, SOAP, GraphQL, OData or SQL API into MCP tools for Claude & ChatGPT. Self-hosted. {adapters} connectors: SAP S/4HANA & Business One, ERP, e-commerce.
+Open-source, self-hosted MCP gateway: turn any REST/OpenAPI, SOAP, GraphQL, OData or SQL API into MCP tools for Claude, ChatGPT & Copilot. {adapters} connectors incl. SAP S/4HANA & Business One, ERP, e-commerce.

LICENSING.md

@@ -29,6 +29,6 @@ Dates).
 ## Contributions
 
 Contributions are accepted under the [Contributor License
-Agreement](CLA.md) — see [CONTRIBUTING.md](CONTRIBUTING.md).
+Agreement](CLA.md) — see [CONTRIBUTING.md](.github/CONTRIBUTING.md).
 
 For commercial licensing inquiries: info@helpcode.ai