Vice City Hub

io.github.vicecityhub由 GitHub 帳號 vicecityhub 發布v12.0.0更新於 Oct 27, 2026

GTA VI news, GTA RP servers, Web3 domains and merch for AI agents, plus crypto donations.

已驗證Streamable HTTP可網頁執行金融商業與電商媒體與設計

概覽

AI 產生的概覽

給 AI 代理使用的 GTA VI 粉絲站:可搜尋新聞、周邊、Web3 網域與 GTA RP 伺服器,並以加密貨幣或 PayPal 下單或捐款。

可以做什麼
  • 搜尋與閱讀內容:檢索商品目錄、新聞與 RP 伺服器,查看單品詳情、文章全文與站內綜合搜尋結果
  • 瀏覽 GTA RP 資料:伺服器、開放派系名額、職業與模組
  • 報價與下單:鎖定價格 15 分鐘、建立訂單、查詢狀態、取消未付款訂單
  • 付款:擷取已核准的 PayPal 訂單,提交或重新驗證鏈上穩定幣付款
  • 帳號與捐款:自助註冊限額 API 金鑰、查看權限與消費額度、了解捐款條款並捐款
  • 對沒有站內結帳的第三方刊登登記購買意願
適用情境
適合需要回答 GTA VI 新聞、GTA RP 伺服器或本站周邊與網域問題的助理,也適合在人工設定消費上限後獲授權購買周邊、網域或商店方案的代理。
執行需求
遠端 streamable-HTTP 端點,不需本機安裝。讀取類工具可匿名使用;下單與捐款工具需在 Authorization 標頭帶上由 register_agent 取得(或由人工簽發)的金鑰。加密付款需在鏈上轉帳穩定幣,PayPal 付款需人工核准連結。
安裝前請注意
下單與捐款工具會花費真實金錢:加密轉帳會被自動偵測並在鏈上驗證,PayPal 訂單需人工核准。金鑰只顯示一次,限額為每筆 100 美元、每日 250 美元。捐款僅應在所代表的人或組織明確授權時進行。訂單與付款會寫入資料,付款後無法撤回。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Vice City Hub,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.vicecityhub%2Fvicecityhub/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "vice-city-hub": {
      "type": "http",
      "url": "https://lpglkglhjdqnktybksth.supabase.co/functions/v1/agent-api/mcp"
    }
  }
}

README

Vice City Hub 🌴 — v12 "Open to Agents"

The GTA VI fan hub for humans and AI agents. Neon UI for people, MCP + REST + llms.txt + safe auto-buy for machines.

Live: https://vicecityhub.github.io/vicecityhub · Agent docs: /llms.txt · Agent console: /agents.html

What v12 adds

LayerWhatWhere
Agent API (REST)catalog, news, RP data, search, quotes, orders, intentssupabase/functions/agent-api/
MCP server17 tools, stateless streamable-HTTP…/agent-api/mcp
Discoveryllms.txt, llms-full.txt, .well-known/{agent.json,mcp.json,api-catalog,ai-plugin.json,security.txt}, openapi.jsongenerated → public/
Static feedsdata/{news,catalog,rp-*}.json + manifest data/index.jsongenerated → public/data/
Per-page SEO/agent markup<link> hints, one JSON-LD @graph, <noscript> contentvite-plugins/agent-surface.ts
Agent purchasesprice-locked quotes → idempotent orders → PayPal or on-chain stablecoin, human-set spend mandatesorders.ts, verify.ts, owner.ts
Human consolemint/revoke spend-limited keys, browse catalog, track orderssrc/pages/Agents.tsx

Humans keep the full neon UI (React SPA per page). Nothing was removed from the human experience.

Single source of truth

site.config.json — name, URLs, page list (titles, descriptions, priorities, feeds). The generator, the Vite plugin, llms.txt, the sitemap and all JSON-LD read from it. Add a page → add one entry there.

Build pipeline

npm run build ├─ prebuild  scripts/gen-agent-surface.mjs   live API → public/{llms*.txt, openapi.json, sitemap.xml, .well-known/*, data/*} ├─ tsc -b └─ vite build   (agentSurface plugin injects discovery links + JSON-LD + <noscript> into every HTML entry)

The generator never fails a build: if the API is unreachable it keeps the previous files (--strict to fail instead). CI (.github/workflows/deploy.yml) rebuilds on push, manually, and every 6 h after the news agent so feeds stay fresh, then verifies the agent files exist in dist/.

Project map

site.config.json            ← edit pages/URLs herevite-plugins/agent-surface.tsscripts/  gen-agent-surface.mjs     ← llms.txt, .well-known, feeds, sitemap  test-agent-api.mjs        ← 30-check safe smoke test (never moves money)  news-agent.mjs            ← scheduled news ingestion  selftest-verify.mjs       ← on-chain verifier self-testpublic/                     ← robots.txt + generated agent files (committed so Pages works even if generation fails)src/{pages,components,lib,rp-hub}supabase/functions/{agent-api,paypal-checkout,printful-hub,link-preview,…}docs/legacy/                ← old one-off notes/scripts (kept, not used)

Agent purchase protocol (short)

  1. POST /v1/agents/register → key ($100/order, $250/day) — or a human mints a bigger mandate in the console.
  2. POST /v1/quotes → price locked 15 min.
  3. POST /v1/orders + Idempotency-Key → next_action (PayPal approve_url or exact-amount stablecoin transfer).
  4. Crypto (no PayPal, fully automatic): send exactly amount_due in USDT/USDC. pg_cron runs the reconciler every minute (/v1/internal/reconcile): it finds the transfer by its unique amount tag, verifies it on-chain, marks the order paid and, for merch, submits the Printful order (PRINTFUL_AUTO_CONFIRM=0 keeps it as a draft). Failed Printful calls are retried by the reconciler. payment-proof is an optional shortcut. PayPal: capture → GET /v1/orders/{id}/status until paid.

Peer listings (partner products, community servers) are intent-only — the Hub never custodies funds for them.

Develop

bash
npm cinpm run dev            # Vitenpm run gen:agent      # regenerate agent surfacenpm run typechecknpm run test:agent     # smoke-test the live Agent APInpm run build

Deploy the edge function: npx supabase functions deploy agent-api --no-verify-jwt --use-api

Known platform limits (GitHub Pages project site)

robots.txt, llms.txt and /.well-known/* are served under /vicecityhub/, not at the host root. Crawlers and some agents look at https://vicecityhub.github.io/robots.txt (root). For full spec-compliant discovery use a custom domain, or publish the same files from a vicecityhub.github.io user-site repo. The Agent API itself (Supabase) serves /v1 index, OpenAPI and MCP from its own root, so it is discoverable regardless.

[ko-fi]

來源:README.md,提交 6fa96dd

工具

19

search_catalog

Search catalog

Search merch, store plans, Web3 domains, partner products and servers for sale. Returns SKUs, USD prices and how each can be bought.

輸入參數qkindsortlimitmax_pricemin_priceorderable

get_item

Get catalog item

Full details for one SKU including variants (merch) and purchase instructions.

輸入參數sku必填

list_news

GTA VI news

Latest curated GTA VI / Rockstar news from The Wire, newest first.

輸入參數qlimitcategoryfeatured

get_news

Get news article

Full article body by numeric id.

輸入參數id必填

list_rp

RP Hub data

GTA RP data: servers, open faction slots, jobs, or mods.

輸入參數limitcollection必填

search_site

Search everything

Cross-search news, catalog and RP servers.

輸入參數q必填

register_agent

Register this agent

Get a self-service API key (limits: $100/order, $250/day). Shown once.

輸入參數name必填modelcontacthomepageoperator

whoami

My key & limits

Scopes, spend limits and 24h spend of the current key.

無需輸入參數。

create_quote

Create price-locked quote

Validate items and lock the price for 15 minutes. Merch must use variant SKUs (merchv:…).

輸入參數items必填

create_order

Create order

Create an order from a quote or items. PayPal rail returns an approve_url that a human must approve; the crypto rail (merch, domains, store plans) is fully automatic: send EXACTLY next_action.amount_due in USDT/USDC and the payment is detected and verified on-chain, no further call needed (poll get_order_status). Merch needs `shipping`, domains need `delivery.wallet_address`, store plans need `details`. Safe to retry with the same idempotency_key.

輸入參數itemsdetailsdeliveryquote_idshippingpayment_rail必填idempotency_key必填

get_order

Get order

Full order incl. next_action.

輸入參數order_id必填

get_order_status

Order status

Cheap status poll (no key needed).

輸入參數order_id必填

capture_paypal_order

Capture PayPal payment

Call after the payer approved payment.approve_url. Idempotent.

輸入參數order_id必填

submit_crypto_payment_proof

Submit crypto tx

Optional shortcut (crypto payments are detected automatically): after sending EXACTLY next_action.amount_due in stablecoins you may submit chain (tron|evm|solana), tx_hash and, for evm, network (polygon|ethereum). The tx is verified on-chain automatically: status becomes paid when final, or payment_review while confirmations accumulate (then call verify_crypto_payment).

輸入參數notechain必填networktx_hash必填order_id必填request_manual_review

verify_crypto_payment

Re-check crypto payment

Re-run on-chain verification for an order whose payment proof is pending confirmations. Idempotent; poll about once a minute.

輸入參數order_id必填

cancel_order

Cancel unpaid order

Cancel an order that is still awaiting_payment.

輸入參數order_id必填

get_donation_info

Donation info

What donations to Vice City Hub fund (developing AI projects and the benefit of AI development), the terms, limits and how an agent can donate. Voluntary; no key needed.

無需輸入參數。

donate

Donate (crypto, automatic)

Voluntary donation that supports developing AI projects and the benefit of AI development. Use ONLY if the person/organization you act for explicitly authorized it (then set authorized_by_principal=true); never on your own initiative. Crypto only: send EXACTLY next_action.amount_due in USDT/USDC; the transfer is detected and verified automatically and the order becomes `completed` with a receipt (poll get_order_status). Needs a key that allows the 'donation' kind and is within its spend limits.

輸入參數donormessageamount_usd必填idempotency_key必填authorized_by_principal必填

create_purchase_intent

Purchase intent

For peer listings without on-site checkout (partner products, community servers, domains without a price). Records interest and returns how to complete the purchase.

輸入參數sku必填contactmessage

版本歷史

1
  1. v12.0.0最新Oct 21, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。