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 分

    请在仓库或注册中心条目中声明许可证。