Input Schema
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"description": "Filter by organization (optional)"
},
"search": {
"type": "string",
"description": "Search in project names and descriptions (optional)"
},
"page": {
"type": "number",
"default": 1
},
"limit": {
"type": "number",
"default": 20,
"maximum": 100
}
}
}
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
organizationId | string | - | Filter by organization |
search | string | - | Search in project names and descriptions |
page | number | 1 | Page number |
limit | number | 20 | Items per page (max 100) |
Response
| Field | Type | Description |
|---|---|---|
items | array | Array of project objects |
items[].id | string | Unique project identifier |
items[].name | string | Display name of the project |
items[].description | string | Project description |
items[].organizationId | string | Parent organization ID |
pagination | object | Pagination metadata |
pagination.page | number | Current page number |
pagination.limit | number | Items per page |
pagination.total | number | Total number of items |
pagination.pages | number | Total number of pages |
Example
Request
{
"search": "marketing"
}
Response
{
"items": [
{
"id": "proj_123",
"name": "Marketing Website",
"description": "Main marketing website content",
"organizationId": "org_456"
},
{
"id": "proj_124",
"name": "Marketing Mobile App",
"description": "Mobile app for marketing campaigns",
"organizationId": "org_456"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 2,
"pages": 1
}
}
Usage
Use this tool to discover available projects before setting context:// List all projects
const result = await mcp.call("list_projects", {});
// Display projects to help select one
for (const project of result.items) {
console.log(`${project.name} (${project.id}) - ${project.description}`);
}
// Set context to the first project
await mcp.call("set_project", { projectId: result.items[0].id });
Filter by Organization
// List projects for a specific organization
const result = await mcp.call("list_projects", {
organizationId: "org_456"
});
Search Projects
// Search for projects by name or description
const result = await mcp.call("list_projects", {
search: "design system"
});