@talqing/mcp 0.1.0 → 0.2.0

package/README.md

@@ -9,13 +9,13 @@ the CoPilot can build, your coding agent can build.
 
 ## What you get
 
-One operation for everything the Talqing dashboard can do. Agents, tools and
-their operation trees, integrations and triggers, knowledge bases from crawl to
-ready, carrier accounts and phone numbers, secrets, provider keys, webhooks and
-tokens; then placing outbound calls, talking to text agents, and reading back
-transcripts, cost and latency. Each one maps to a Talqing API endpoint, and its
-arguments mirror that HTTP call: path and query parameters at the top level,
-request body under `body`.
+One operation for everything a workspace is built out of. Agents and agent
+tasks, tools and their operation trees, integrations and triggers, knowledge
+bases from crawl to ready, carrier accounts and phone numbers, secrets, provider
+keys and webhooks; then placing outbound calls, running call and email batches,
+talking to text agents, and reading back transcripts, cost and latency. Each one
+maps to a Talqing API endpoint, and its arguments mirror that HTTP call: path and
+query parameters at the top level, request body under `body`.
 
 A few request types are large enough that carrying them in every tool that
 accepts one would cost more context than the whole rest of the server — an
@@ -34,11 +34,19 @@ ready-to-paste command for each client — the snippets below are what it shows.
 The token authenticates as you, acts with your current role, and reaches only
 your workspace.
 
+**`TALQING_BASE_URL` names a region** — `https://api.in.talqing.com`,
+`https://api.us.talqing.com` — and everything this server can reach belongs to
+that one: an agent, its calls, its phone numbers and its credit balance are all
+the region's. One token reaches every region — it names your workspace, not a
+place — so working in another region is the same token and a different base URL.
+The dashboard's snippet always carries the region you are currently looking at;
+switch region there and copy it again.
+
 **Claude Code**
 
 ```bash
 claude mcp add talqing \
-  -e TALQING_BASE_URL=https://api.your-talqing-host.com \
+  -e TALQING_BASE_URL=https://api.in.talqing.com \
   -e TALQING_API_KEY=tq_your_token \
   -- npx -y @talqing/mcp
 ```
@@ -47,7 +55,7 @@ claude mcp add talqing \
 
 ```bash
 codex mcp add talqing \
-  --env TALQING_BASE_URL=https://api.your-talqing-host.com \
+  --env TALQING_BASE_URL=https://api.in.talqing.com \
   --env TALQING_API_KEY=tq_your_token \
   -- npx -y @talqing/mcp
 ```
@@ -59,7 +67,7 @@ codex mcp add talqing \
 [mcp_servers.talqing]
 command = "npx"
 args = ["-y", "@talqing/mcp"]
-env = { TALQING_BASE_URL = "https://api.your-talqing-host.com", TALQING_API_KEY = "tq_your_token" }
+env = { TALQING_BASE_URL = "https://api.in.talqing.com", TALQING_API_KEY = "tq_your_token" }
 ```
 
 **Any other MCP client** — a stdio server, configured the usual way:
@@ -71,7 +79,7 @@ env = { TALQING_BASE_URL = "https://api.your-talqing-host.com", TALQING_API_KEY
       "command": "npx",
       "args": ["-y", "@talqing/mcp"],
       "env": {
-        "TALQING_BASE_URL": "https://api.your-talqing-host.com",
+        "TALQING_BASE_URL": "https://api.in.talqing.com",
         "TALQING_API_KEY": "tq_your_token"
       }
     }
@@ -91,9 +99,20 @@ the rest, exactly as they would through the dashboard.
 Operations are annotated so clients can tell reads from writes — `readOnlyHint`
 on every GET, `destructiveHint` on every delete.
 
-Two things are deliberately out of reach: streaming endpoints — their polling
-equivalents are here, so nothing is unreachable — and user management, which
-stays in the dashboard where a human is in the loop.
+Four things are deliberately out of reach:
+
+- **Sign-in, organizations, members and roles, and personal access tokens.**
+  Those live on a separate control API that this server holds no URL for, so an
+  AI builder cannot mint itself a credential, and who is in the workspace stays
+  where a human is in the loop.
+- **Buying credits.** Reading the balance would be harmless; starting a payment
+  spends the workspace's money, and neither belongs on a coding agent's surface.
+- **Streaming endpoints**, which are not tool-shaped. Every one has a polling
+  equivalent here — `list_conversation_items` for a conversation, `get_kb` for a
+  knowledge build — so nothing is unreachable.
+- **Deleting a call or its recording.** Every other `delete_*` removes
+  configuration you could write again; this one destroys the record of something
+  that happened, and can take a contact's memory of past calls with it.
 
 Some operations act on the real world. `create_outbound_call` rings a phone and
 costs money, and a message to a connected channel is one somebody receives.
@@ -116,7 +135,7 @@ cd mcp && npm install && npm run build
       "command": "node",
       "args": ["/absolute/path/to/talqing/mcp/dist/index.js"],
       "env": {
-        "TALQING_BASE_URL": "https://api.your-talqing-host.com",
+        "TALQING_BASE_URL": "https://api.in.talqing.com",
         "TALQING_API_KEY": "tq_your_token"
       }
     }
@@ -135,8 +154,8 @@ cannot drift from the product:
 PYTHONPATH=backend python openapi/export.py
 ```
 
-`tools.json` comes from `backend/api/operations.py`, the same registry the
-CoPilot binds its tools from; `SKILL.md` comes from
+`tools.json` comes from `backend/api/dataplane/operations.py`, the same registry
+the CoPilot binds its tools from; `SKILL.md` comes from
 `backend/services/copilot/skill.md`, the same text the CoPilot is prompted with.
 Edit those, re-run the export, and both surfaces move together.
 

package/SKILL.md

@@ -27,6 +27,12 @@ request body under `body`. Every operation acts as the signed-in user, inside
 their workspace only, with their role's permissions. Managing who is in the
 workspace is the one thing that stays in the dashboard.
 
+**Everything here belongs to one region.** A workspace exists in every region and
+its resources do not: an agent, its calls, its phone numbers and its credit
+balance all live in the region whose API you are pointed at. One token reaches
+every region — it names the workspace, not a place — so working in another one is
+the same token and a different base URL.
+
 ## What an agent is
 
 An agent is a single object, `config`, plus what you attach to it:
@@ -35,7 +41,8 @@ An agent is a single object, `config`, plus what you attach to it:
 - **`channel`** — `voice` (phone/web call), `video` (a voice agent wearing an
   Anam avatar) or `text` (chat). The channel decides which model slots exist.
 - **`prompt`** — the system prompt. This is where the agent's behaviour lives.
-- **`greeting`** — the line spoken on connect. Voice and video only.
+- **`greeting`** — the line spoken on connect, and on the way in from a
+  handoff. Voice and video only.
 
   Both are personalized per session: `{{userdata.field}}` is substituted from
   the session's userdata when the agent starts, so *"You are speaking with
@@ -152,8 +159,8 @@ An agent is a single object, `config`, plus what you attach to it:
   `{"integration_id": "..."}` naming an active, MCP-capable integration. Which
   of a server's tools may be called is the integration's own `allowed_tools`,
   not this list. As with `tools`, an entry may instead carry `{"mcp": {name,
-  url, headers, allowed_tools}}`, which is created as a `custom_mcp` integration
-  and replaced by its id.
+  url, headers, allowed_tools, tools_namespace}}`, which is created as a
+  `custom_mcp` integration and replaced by its id.
 - **`handoffs`** — where this agent may pass the conversation next, each
   `{"name": "Billing", "agent_id": "...", "description": "...", "context":
   "transcript" | "summary" | "none", "recent_turns": 2, "summary_prompt": "...",
@@ -770,9 +777,10 @@ before hanging up — logging the outcome, posting a lead — goes **before** th
 
 Each hook points at a **published tool id**, or null.
 
-- **`on_enter`** — a session opens. On voice and video it runs alongside the
-  greeting on first entry; on text, when the conversation window opens. Handoffs
-  skip the greeting.
+- **`on_enter`** — a session opens. It finishes *before* the greeting, which
+  waits for it and reads whatever it published to userdata; on text, when the
+  conversation window opens. A handoff target runs it and then speaks its own
+  greeting — or, having none, opens with a generated line instead.
 - **`on_exit`** — the session closes: call end or handoff on voice and video;
   on text, `end_call`, a closed window, or about a minute idle.
 - **`on_user_turn_completed`** — after every user turn, before the LLM replies.
@@ -915,6 +923,14 @@ every turn, and a voice agent picking from ninety of them is slower and less
 accurate than one picking from six. Unlike the attachment, that approval is
 live: narrowing it reaches every already-published agent on its next turn.
 
+The model does not see a server's tool names raw. Each is prefixed with the
+integration's `tools_namespace` — `<namespace>_<tool>`, defaulting to the
+provider key for a hosted provider and to nothing for a custom server. Read it
+back off the integration, or read `exposed_name` from
+`list_integration_mcp_tools`, and **write prompts against the exposed name**;
+`allowed_tools` still approves the server's own names. Two attached servers
+sharing a namespace fails publish.
+
 **Channel integrations** (Telegram) deploy an agent to a messaging
 channel through *triggers*, not MCP attachment. A trigger binds an inbound event
 to a published text agent and decides what happens with the reply.
@@ -1018,8 +1034,9 @@ afterwards will not forgive us:
 - **Every row runs the task as it stands right now.** Editing it while a batch
   is drafting changes every row generated after that moment, and there is no way
   to get the old wording back.
-- **Bounces and spam complaints are only visible if they point a Resend webhook
-  at this workspace.** The URL is on the integration's page.
+- **Talqing reports what it sent, not what landed.** Deliveries, bounces and
+  spam complaints live in the Resend dashboard, and watching them there is how a
+  sending domain survives.
 
 ### The column space
 
@@ -1091,9 +1108,6 @@ or on the first `configuration` failure (a deleted task, a field map an edit
 broke) or the first account-level send failure (a revoked key, an unverified
 domain) — because those will fail identically for every remaining row.
 
-`delivery_status` on a row is Resend's verdict, separate from ours: `sent` is
-what we did, `delivered` / `bounced` / `complained` is what happened next.
-
 ## Knowledge bases
 
 A knowledge base gives an agent grounded answers over crawled content. Attach

package/dist/index.js

@@ -29,9 +29,13 @@ function required(name, hint) {
     return value;
 }
 const BASE_URL = required("TALQING_BASE_URL", "set it to your Talqing API URL, e.g. https://api.your-talqing-host.com").replace(/\/+$/, "");
-const API_KEY = required("TALQING_API_KEY", "create a personal access token in the dashboard under Settings → Tokens");
+const API_KEY = required("TALQING_API_KEY", "create a personal access token in the dashboard under Organization → API Tokens");
 const { tools: operations } = JSON.parse(readPackageFile("tools.json"));
 const byName = new Map(operations.map((operation) => [operation.name, operation]));
+/* Read, not restated. A client shows this version when it reports the server it
+   connected to, and a second copy of the number is one `npm version` away from
+   being wrong. */
+const { version: VERSION } = JSON.parse(readPackageFile("package.json"));
 /** The skill, minus its frontmatter — handed to the client as server instructions. */
 function instructions() {
     const markdown = readPackageFile("SKILL.md");
@@ -108,7 +112,7 @@ async function call(name, args) {
     }
     return { content: [{ type: "text", text: text || "{}" }] };
 }
-const server = new Server({ name: "talqing", version: "0.1.0" }, { capabilities: { tools: {} }, instructions: instructions() });
+const server = new Server({ name: "talqing", version: VERSION }, { capabilities: { tools: {} }, instructions: instructions() });
 server.setRequestHandler(ListToolsRequestSchema, async () => ({
     tools: operations.map(describe),
 }));

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talqing/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for building Talqing AI voice, video and text agents from Claude Code, Codex, or any MCP client.",
   "license": "MIT",
   "homepage": "https://talqing.com",

package/tools.json

@@ -2,20 +2,6 @@
   "api_prefix": "/v1",
   "api_version": "1.0.0",
   "tools": [
-    {
-      "description": "Who this credential is: the signed-in user, their role, and the organization.\n\nEverything else you can reach is scoped to that organization, and `role`\n(`ADMIN`, `EDITOR` or `VIEWER`) decides whether writes will be accepted. A\nuser may belong to several organizations with a different role in each; this\nreports the one this credential is for.",
-      "method": "GET",
-      "name": "me",
-      "parameters": {
-        "additionalProperties": false,
-        "properties": {},
-        "required": [],
-        "type": "object"
-      },
-      "path": "/v1/auth/me",
-      "read_only": true,
-      "role": "read"
-    },
     {
       "description": "List the workspace's agents, newest edit first.\n\nEach item carries the full draft config and the published version number\n(null while the agent has never been published).",
       "method": "GET",
@@ -1009,6 +995,17 @@
                 "additionalProperties": true,
                 "type": "object"
               },
+              "tools_namespace": {
+                "anyOf": [
+                  {
+                    "pattern": "^$|^[a-z][a-z0-9_]{0,23}$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
               "webhook_config": {
                 "additionalProperties": true,
                 "type": "object"
@@ -1154,6 +1151,17 @@
                   }
                 ]
               },
+              "tools_namespace": {
+                "anyOf": [
+                  {
+                    "pattern": "^$|^[a-z][a-z0-9_]{0,23}$",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              },
               "webhook_config": {
                 "anyOf": [
                   {
@@ -5659,88 +5667,6 @@
       "read_only": false,
       "role": "admin"
     },
-    {
-      "description": "List personal access tokens: your own, or every one in the organization\nif you are an admin.\n\nWho holds which credential is organization-admin information, so an EDITOR\nor VIEWER sees only what they created. Plaintext token values are never\nreturned. A token with `kind: mcp` was issued automatically for the\ndashboard's MCP setup; the rest were created by hand.",
-      "method": "GET",
-      "name": "list_tokens",
-      "parameters": {
-        "additionalProperties": false,
-        "properties": {
-          "limit": {
-            "default": 200,
-            "maximum": 200,
-            "minimum": 1,
-            "type": "integer"
-          },
-          "offset": {
-            "default": 0,
-            "minimum": 0,
-            "type": "integer"
-          }
-        },
-        "required": [],
-        "type": "object"
-      },
-      "path": "/v1/tokens",
-      "read_only": true,
-      "role": "read"
-    },
-    {
-      "description": "Create a personal access token for driving this API without the dashboard.\n\nThe token authenticates as its creator and acts with that user's live role,\nso it can never do more than they can. It does not expire; deleting it is\nthe revocation. The plaintext value is returned once here and never again \u2014\ntreat it like a password and do not echo it back into a conversation.",
-      "method": "POST",
-      "name": "create_token",
-      "parameters": {
-        "$defs": {
-          "CreateTokenRequest": {
-            "properties": {
-              "name": {
-                "maxLength": 100,
-                "minLength": 1,
-                "type": "string"
-              }
-            },
-            "required": [
-              "name"
-            ],
-            "type": "object"
-          }
-        },
-        "additionalProperties": false,
-        "properties": {
-          "body": {
-            "$ref": "#/$defs/CreateTokenRequest"
-          }
-        },
-        "required": [
-          "body"
-        ],
-        "type": "object"
-      },
-      "path": "/v1/tokens",
-      "read_only": false,
-      "role": "read"
-    },
-    {
-      "description": "Revoke a token immediately and permanently.\n\nOwners can delete their own; organization admins can delete any in the\norganization. Deleting an `mcp` token rotates it: the owner's next dashboard\nvisit issues a replacement, and anything still configured with the old one\nstops working.",
-      "method": "DELETE",
-      "name": "delete_token",
-      "parameters": {
-        "additionalProperties": false,
-        "properties": {
-          "token_id": {
-            "format": "uuid",
-            "type": "string"
-          }
-        },
-        "required": [
-          "token_id"
-        ],
-        "type": "object"
-      },
-      "path": "/v1/tokens/{token_id}",
-      "read_only": false,
-      "role": "read"
-    },
     {
       "description": "The full JSON Schema of one of the five large request types.\n\nAn argument whose description ends in `describe_schema('X')` carries only a\nplaceholder for its shape \u2014 fetch the real one here before writing it.\n\n- `AgentConfig` \u2014 a whole agent definition; what `create_agent` takes.\n- `AgentOverride` \u2014 the same tree, every field optional, for one call.\n- `AgentTeam` \u2014 several agents on one call, handing off to each other.\n- `TaskConfig` \u2014 an agent task: inputs, output shape, model stack.\n- `ToolOperations` \u2014 the operation tree a custom tool runs.\n\nThese compose, so a document you fetch may itself defer to another.",
       "method": "GET",