Tools & Capabilities

TeamDay agents have three categories of tools: built-in Claude tools, platform MCP tools, and external MCP integrations.

Built-in Claude Tools

Every agent gets these tools automatically. They operate on the Space's filesystem (sandbox directory).

File Operations

ToolDescription
ReadRead file contents. Supports text files, images, PDFs, and Jupyter notebooks.
WriteCreate or overwrite files in the workspace.
EditMake targeted string replacements in existing files.
GlobFind files by pattern (e.g., **/*.ts, src/**/*.vue).
GrepSearch file contents with regex. Supports context lines and file type filters.

Execution

ToolDescription
BashRun shell commands in the workspace. Has a 2-minute default timeout.

Web

ToolDescription
WebSearchSearch the web and return results with links.
WebFetchFetch a URL and process its content. Converts HTML to markdown.

Agent Coordination

ToolDescription
TaskLaunch specialized subagents for complex, multi-step tasks.
SendMessageCommunicate between agents in a team.

These tools are always available unless explicitly restricted via the allowedTools field on a Character.

Platform MCP Tools

TeamDay provides three built-in MCP tools that give agents control over the platform itself.

MediaGeneration

Generate images and videos with AI.

mcp__teamday-media__MediaGeneration
ActionDescription
generateImageText-to-image (Flux 2, Grok models)
generateAvatarSquare profile image
imageToVideoAnimate images into video clips (Kling, Wan, Grok)
checkBalanceCheck credit balance before generating

Image models: flux-2-flex (4c), grok-imagine-image (3c), grok-imagine-image-pro (11c) Video models: kling (53c/5s), wan (30c/5s), grok (38c/5s)

See Media Generation for full docs.

TeamdayAdmin

Manage platform resources programmatically — spaces, agents, characters, MCPs, missions, skills, and secrets.

mcp__teamday-admin__TeamdayAdmin

Key actions: createSpace, updateSpace, createAgent, createCharacter, createMission, storeSecrets, discoverSpace, browseSkillsRegistry, browseMcpRegistry

See TeamDay Admin for full docs.

UICommand

Control the chat interface from agent code.

mcp__teamday-ui__UICommand

Key actions: listAgents, switchAgent, showNotification, askConfirmation, askQuestion, openModal, openPanel, navigate

See UI Commands for full docs.

External MCP Integrations

MCP (Model Context Protocol) servers connect agents to external tools and services. Install them on a Space to make them available to all agents in that workspace.

Installing MCPs

Via CLI:

teamday spaces add-mcp <space-id> google-analytics

Via API:

curl -X PATCH "https://us.teamday.ai/api/v1/spaces/<space-id>" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"addMcps": ["google-analytics-id"]}'

Via TeamdayAdmin tool (in-chat):

{
  "action": "browseMcpRegistry"
}

Creating MCP Instances

Create a custom MCP configuration for your organization:

Via CLI:

teamday mcps create \
  --type google-search \
  --name "My Google Search" \
  --credentials '{"API_KEY": {"value": "abc123", "isSecret": true}}'

Via API:

curl -X POST "https://us.teamday.ai/api/v1/mcps" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "google-analytics",
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@anthropic-ai/mcp-google-analytics"],
    "env": {"GA_PROPERTY_ID": "12345678"}
  }'

How MCP Tools Appear

When an MCP server is installed, its tools become available with the naming pattern:

mcp__{server-name}__{tool-name}

For example, if you install an Ahrefs MCP server named ahrefs, the agent can use tools like:

  • mcp__ahrefs__site-explorer-domain-rating
  • mcp__ahrefs__keywords-explorer-overview

OAuth MCPs

Some MCPs require OAuth authentication (e.g., Google Analytics, Google Search Console). These use a browser-based OAuth flow:

  1. Install the MCP on a Space
  2. The UI prompts you to connect your account
  3. Tokens are stored securely and refreshed automatically

If a token expires during a conversation, the agent can request re-authentication:

{
  "action": "requestReauth",
  "target": "google-analytics"
}

See MCP Servers for more details.

File-Based Configuration

In addition to API-managed tools, agents discover tools from the Space filesystem:

.mcp.json

Place an .mcp.json file in the Space root to configure MCP servers:

{
  "mcpServers": {
    "my-custom-tool": {
      "command": "node",
      "args": ["tools/my-tool/index.js"],
      "env": {
        "API_KEY": "${API_KEY}"
      }
    }
  }
}

Environment variable references (${VAR}) are resolved from the Space's secrets.

.claude/agents/

Agent markdown files in .claude/agents/ are discovered as subagents:

---
name: Data Analyst
role: SQL and reporting
tools: [Read, Write, Bash]
---
You are a data analyst who writes SQL queries and generates reports.

.claude/skills/

Skill definitions in .claude/skills/{name}/SKILL.md extend agent capabilities:

.claude/skills/report-generator/
  SKILL.md
  scripts/
    generate.ts

See Skills for the full skill format.

Next Steps