Skip to content

Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web component. Remote MCP server, x402 payments, Three.js, browser-native.

feat(x-content): let a queued post quote an existing one, and queue the MCP catalog follow-up

nirholas76fbdbd95842
diff --git a/api/_lib/x-content/publisher.js b/api/_lib/x-content/publisher.js
index 7f697dc7a..553b64076 100644
--- a/api/_lib/x-content/publisher.js
+++ b/api/_lib/x-content/publisher.js
@@ -118,7 +118,9 @@ export async function publishItem({ item, client, root, state, store, account =
const persist = () => store.save(state);
if (item.kind === 'article') await publishArticle({ client, root, item, progress, persist });
- else await publishPosts({ client, root, posts: item.posts, progress, persist });
+ // `quotes` makes the head post a quote tweet of an existing post, which is how
+ // a follow-up adds the detail its original left out without repeating it.
+ else await publishPosts({ client, root, posts: item.posts, progress, persist, quoteId: item.quotes || null });
const leadId = progress.articlePostId || progress.postIds[0];
const row = {
diff --git a/api/_lib/x-content/queue.js b/api/_lib/x-content/queue.js
index 678f23433..87a8a36b7 100644
--- a/api/_lib/x-content/queue.js
+++ b/api/_lib/x-content/queue.js
@@ -126,6 +126,12 @@ export function validateItem(item, root) {
if (!Number.isFinite(Date.parse(item.notBefore))) problems.push('notBefore must be an ISO-8601 timestamp');
if (![1, 2, 3].includes(Number(item.tier))) problems.push('tier must be 1 (flagship), 2 (feature), or 3 (proof of work)');
if (item.expiresAt !== undefined && !Number.isFinite(Date.parse(item.expiresAt))) problems.push('expiresAt must be an ISO-8601 timestamp');
+ // `quotes` is the numeric id of the post this one quotes. X takes the id, not
+ // the URL, so a pasted status link is rejected here rather than at publish.
+ if (item.quotes !== undefined) {
+ if (item.kind !== 'post') problems.push('quotes is only for post items; an article already quotes itself');
+ if (!/^[0-9]{5,25}$/.test(String(item.quotes))) problems.push('quotes must be a post id (digits only), not a URL');
+ }
if (item.priority !== undefined && !(Number(item.priority) >= -50 && Number(item.priority) <= 50)) problems.push('priority is an owner boost from -50 to 50');
for (const probe of item.probes || []) {
if (!['api', 'browser', 'command'].includes(probe.type)) problems.push(`probe type ${probe.type} must be api, browser, or command`);
diff --git a/data/x-content/cards/mcp-catalog-detail.json b/data/x-content/cards/mcp-catalog-detail.json
new file mode 100644
index 000000000..a5a8271ce
--- /dev/null
+++ b/data/x-content/cards/mcp-catalog-detail.json
@@ -0,0 +1,10 @@
+{
+ "out": "public/x-media/mcp-catalog-detail/card.png",
+ "headline": "321 MCP tools.\nEvery label checked.",
+ "body": "42 servers, 293 of them free. The read-only label on each tool is verified against its source on every build, so your assistant can act on it.",
+ "frame": "browser",
+ "shot": "https://three.ws/mcp-tools?server=three-token-mcp",
+ "label": "three.ws/mcp-tools",
+ "settleMs": 20000,
+ "headlineSize": 68
+}
diff --git a/data/x-content/cards/mcp-catalog-tools.json b/data/x-content/cards/mcp-catalog-tools.json
new file mode 100644
index 000000000..84b7b7c45
--- /dev/null
+++ b/data/x-content/cards/mcp-catalog-tools.json
@@ -0,0 +1,11 @@
+{
+ "out": "public/x-media/mcp-catalog-tools/card.png",
+ "headline": "Three tools.\nOne of them burns.",
+ "headlineSize": 68,
+ "body": "three_balance and three_price read. three_burn signs on Solana mainnet, so the catalog marks it irreversible and it refuses to run without confirm: true.",
+ "frame": "browser",
+ "shot": "https://three.ws/mcp-tools?server=three-token-mcp",
+ "label": "three.ws/mcp-tools?server=three-token-mcp",
+ "scrollBy": 1500,
+ "settleMs": 20000
+}
diff --git a/data/x-content/queue.json b/data/x-content/queue.json
index 3f764664f..8e9797bec 100644
--- a/data/x-content/queue.json
+++ b/data/x-content/queue.json
@@ -1064,6 +1064,107 @@
]
}
]
+ },
+ {
+ "id": "mcp-catalog",
+ "status": "review",
+ "kind": "post",
+ "tier": 2,
+ "lane": "mcp",
+ "pattern": "proof",
+ "notBefore": "2026-09-20T05:00:00Z",
+ "quotes": "2101524482313920723",
+ "claims": [
+ {
+ "says": "checked against the code on every build",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools",
+ "contains": "checked against the code on every build"
+ }
+ ]
+ },
+ {
+ "says": "three_burn signs on Solana mainnet",
+ "evidence": [
+ {
+ "type": "page",
+ "url": "https://three.ws/mcp-tools?server=three-token-mcp&tool=three_burn",
+ "contains": "signs and broadcasts on Solana mainnet"
+ },
+ {
+ "type": "file",
+ "path": "packages/three-token-mcp/src/tools/three-burn.js",
+ "contains": "confirm"
+ }
+ ]
+ }
+ ],
+ "probes": [
+ {
+ "type": "api",
+ "name": "the catalog serves 321 tools",
+ "url": "https://three.ws/mcp-catalog.json",
+ "expect": {
+ "json": {
+ "path": "counts.tools",
+ "equals": 321
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "across 42 servers",
+ "url": "https://three.ws/mcp-catalog.json",
+ "expect": {
+ "json": {
+ "path": "counts.servers",
+ "equals": 42
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "215 of them are verified reads",
+ "url": "https://three.ws/mcp-catalog.json",
+ "expect": {
+ "json": {
+ "path": "counts.read",
+ "equals": 215
+ }
+ }
+ },
+ {
+ "type": "api",
+ "name": "the pasteable profile is served live",
+ "url": "https://three.ws/api/mcp-policy?profile=balanced&format=claude",
+ "expect": {
+ "status": 200,
+ "contains": "mcp__three-token-mcp__three_balance"
+ }
+ }
+ ],
+ "posts": [
+ {
+ "text": "321 MCP tools across 42 servers, 293 free.\n\nEvery read-only label is checked against the code on every build, so one pasted profile runs 215 of them without asking you.\n\nthree.ws/mcp-tools",
+ "media": [
+ {
+ "path": "public/x-media/mcp-catalog-detail/card.png",
+ "alt": "A three.ws card reading '321 MCP tools. Every label checked.' beside a browser window showing the three.ws MCP Tool Catalog: counters reading 321 tools, 42 servers, 215 read-only, 81 writes, 25 irreversible, 293 free and 28 paid, above three permission profiles named Strict, Balanced and Open"
+ }
+ ]
+ },
+ {
+ "text": "This server is three of those tools.\n\nthree_balance and three_price read. three_burn signs on Solana mainnet, so it is labelled irreversible and will not run without confirm: true.",
+ "media": [
+ {
+ "path": "public/x-media/mcp-catalog-tools/card.png",
+ "alt": "A three.ws card reading 'Three tools. One of them burns.' beside a browser window showing the catalog filtered to the three-token-mcp server: three_balance and three_price each badged Read-only and Free, and three_burn badged Irreversible and Free, each with its full description"
+ }
+ ]
+ }
+ ]
}
]
}
diff --git a/public/x-media/mcp-catalog-detail/card.png b/public/x-media/mcp-catalog-detail/card.png
new file mode 100644
index 000000000..3b54e98a3
Binary files /dev/null and b/public/x-media/mcp-catalog-detail/card.png differ
diff --git a/public/x-media/mcp-catalog-tools/card.png b/public/x-media/mcp-catalog-tools/card.png
new file mode 100644
index 000000000..7eaf41d9d
Binary files /dev/null and b/public/x-media/mcp-catalog-tools/card.png differ
diff --git a/tests/x-content.test.js b/tests/x-content.test.js
index f3ad32941..4fc6f04c0 100644
--- a/tests/x-content.test.js
+++ b/tests/x-content.test.js
@@ -396,6 +396,23 @@ describe('queue', () => {
for (const item of queue.items.filter((row) => row.status === 'approved')) expect(problems[item.id]).toEqual([]);
});
+ it('takes a post id for a quote tweet and refuses a pasted URL', async () => {
+ const { publishItem, previewClient } = await import('../api/_lib/x-content/publisher.js');
+ const dir = sandbox();
+ const base = { id: 'quote-post', status: 'draft', kind: 'post', tier: 2, lane: 'l', pattern: 'p', notBefore: '2026-09-20T00:00:00Z', textOnly: true, posts: [{ text: HEAD }, { text: 'A reply that carries the rest of it.' }] };
+ expect(validateItem({ ...base, quotes: '2101524482313920723' }, dir)).toEqual([]);
+ expect(validateItem({ ...base, quotes: 'https://x.com/trythreews/status/2101524482313920723' }, dir)).toContain('quotes must be a post id (digits only), not a URL');
+
+ // Only the head quotes; the reply still threads under it.
+ const client = previewClient();
+ const state = { inflight: {} };
+ await publishItem({ item: { ...base, quotes: '2101524482313920723' }, client, root: dir, state, store: { save: async () => {} } });
+ const tweets = client.calls.filter((call) => call.call === 'tweets.create');
+ expect(tweets[0].quote_tweet_id).toBe('2101524482313920723');
+ expect(tweets[1].quote_tweet_id).toBeUndefined();
+ expect(tweets[1].reply.in_reply_to_tweet_id).toBe(tweets[0] && 'preview-post-1');
+ });
+
it('requires media on the head post unless text-only is explicit', () => {
const dir = sandbox();
const base = { id: 'demo', status: 'review', kind: 'post', tier: 2, lane: 'l', pattern: 'p', notBefore: '2026-09-17T14:00:00Z' };