# List Applications — Writer

> List the no-code applications (agents) in your Writer workspace. Use this to see which saved agents exist and to resolve an agent's id, then call Get Application to inspect its inputs and Run Application to run it. Handles an empty…

- Key: `writer-list-applications`
- Type: Action (Read-only)
- Version: 0.0.2
- App: Writer (`writer`) — https://pipedream.com/apps/writer.md
- This page (HTML): https://pipedream.com/apps/writer/actions/list-applications
- Hints: read-only · open-world
- Source: https://github.com/PipedreamHQ/pipedream/blob/master/components/writer/actions/list-applications/list-applications.mjs

## Description

List the no-code applications (agents) in your Writer workspace. Use this to see which saved agents exist and to resolve an agent's `id`, then call **Get Application** to inspect its inputs and **Run Application** to run it. Handles an empty workspace gracefully (returns an empty list). Auto-paginates up to 200 applications. Example: to list the content-generation agents and see just their names, call with `type="generation"` and `fields=["name"]` -> returns records like `{ id: "...", name: "Blog Writer" }`. [See the documentation](https://dev.writer.com/api-reference/application-api/list-applications)

## Props

| Prop | Type | Required | Description |
|---|---|---|---|
| `type` | `string` | No | Filter by application type. generation for content-generation agents or research for research agents. Defaults to generation when omitted. |
| `fields` | `string[]` | No | Field names to return for each application (id is always included). Defaults to: name, type, status. Available fields include name, type, status, created_at, updated_at. Pass only what you need to keep responses small. |
| `maxResults` | `integer` | No | Maximum number of results to return. |

## Run it

**MCP**

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "writer",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// listTools() hands your model this tool's input schema, so it can
// fill the arguments itself:
const result = await mcp.callTool({
  name: "writer-list-applications",
  arguments: {
    type: "Application Type",
    fields: ["Fields"],
  },
})
```

**TypeScript**

```ts
import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "writer-list-applications",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    writer: { authProvisionId: "apn_xxxxxxx" },
    type: "Application Type",
    fields: ["Fields"],
  },
})

console.log(result)
```

**cURL**

```bash
curl -X POST https://api.pipedream.com/v1/connect/{project_id}/actions/run \
  -H "Content-Type: application/json" \
  -H "X-PD-Environment: production" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "external_user_id": "{external_user_id}",
    "id": "writer-list-applications",
    "configured_props": {
      "writer": { "authProvisionId": "apn_xxxxxxx" },
      "type": "Application Type",
      "fields": ["Fields"]
    }
  }'
```

---

- App: https://pipedream.com/apps/writer.md · All apps: https://pipedream.com/apps