> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Tools CLI

> Command-line interface for MCP servers

Manage and use MCP servers from the command line.

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
graph LR
    User([User]) --> CLI[CLI]
    CLI --> Svc[MCP Tools]

    classDef agent fill:#8B0000,stroke:#7C90A0,color:#fff
    classDef tool fill:#189AB4,stroke:#7C90A0,color:#fff

    class Svc agent
    class User,CLI tool
    classDef agent fill:#8B0000,color:#fff
    classDef tool fill:#189AB4,color:#fff

```

## Quick Start

<Steps>
  <Step title="Simple Usage">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai-ts mcp list --url https://mcp-server.example.com/api
    ```
  </Step>

  <Step title="With Configuration">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai-ts mcp run --url https://mcp-server.example.com/api --tool read_file --args '{"path":"."}' --json
    ```
  </Step>
</Steps>

## Commands

### List MCP Tools

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# List tools from stdio server
praisonai-ts mcp list \
  --command "npx -y @modelcontextprotocol/server-filesystem /path"

# List from HTTP server
praisonai-ts mcp list --url https://mcp-server.example.com/api
```

### Run MCP Tool

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Execute a tool
praisonai-ts mcp run read_file \
  --command "npx -y @modelcontextprotocol/server-filesystem /path" \
  --args '{"path": "file.txt"}'
```

### List Resources

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-ts mcp resources \
  --command "npx -y @modelcontextprotocol/server-filesystem /path"
```

### List Prompts

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai-ts mcp prompts \
  --command "npx -y @modelcontextprotocol/server-filesystem /path"
```

## Options

| Option        | Type    | Description           |
| ------------- | ------- | --------------------- |
| `--command`   | string  | Stdio command         |
| `--url`       | string  | HTTP/SSE URL          |
| `--transport` | string  | Transport type        |
| `--args`      | string  | Tool arguments (JSON) |
| `--json`      | boolean | JSON output           |

## Examples

### Filesystem Server

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# List files
praisonai-ts mcp run list_directory \
  --command "npx -y @modelcontextprotocol/server-filesystem ." \
  --args '{"path": "."}'
```

### GitHub Server

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
GITHUB_TOKEN=ghp_... praisonai-ts mcp list \
  --command "npx -y @modelcontextprotocol/server-github"
```

## Environment Variables

| Variable        | Description             |
| --------------- | ----------------------- |
| Server-specific | MCP server requirements |

## Related Commands

* `praisonai-ts mcp test` - Test MCP connection
* `praisonai-ts mcp info` - Show server info

## Related

<CardGroup cols={2}>
  <Card title="MCP Tools" icon="book" href="/docs/js/mcp-tools">MCP Tools overview</Card>
  <Card title="Tools CLI" icon="robot" href="/docs/js/tools-cli">Tools CLI overview</Card>
</CardGroup>