# Fibery MCP GraphQL Server

This is a Model Context Protocol (MCP) server that provides tools to introspect the Fibery GraphQL API to help your LLM to write valid graphql queries and mutations.

## Features

- **List Spaces and Types**: Fetches and lists all available GraphQL spaces and types in your Fibery account
- **Get Schema SDL**: Gets the complete GraphQL schema SDL for a Fibery space
- **Validate Fibery GraphQL**: Validates a generated GraphQL query or mutation for Fibery against the known schema

## Prerequisites

- Node.js (v20 or higher)
- Fibery account with API access

## Using with MCP Clients

This server implements the Model Context Protocol and can be used with any MCP-compatible client. The MCP endpoint is available at:

```json
{
  "mcpServers": {
    "fibery-mcp-graphql": {
      "command": "node", // note: if using nvm, use the full path to the version of node you want to use
      "args": ["/full-path-to/index.js"],
      "env": {
        "FIBERY_TOKEN": "your_fibery_token",
        "FIBERY_URL": "your_fibery_domain.fibery.io"
      }
    }
  }
}
```

## Installation

1. Clone the repository
2. Install dependencies:

```bash
bun install
```

## MCP Tools

### list_spaces_and_types

Lists all available GraphQL spaces and types in your Fibery account.

**Parameters**: None

**Response**:
```json
{
  "spaces": [
    {
      "name": "Space Name",
      "url": "https://your-domain.fibery.io/api/graphql/space/Space_Name",
      "id": "Space_Name"
    },
    ...
  ],
  "count": 5
}
```

### get_schema_sdl

Gets the complete GraphQL schema SDL for a Fibery space. This includes all type definitions, queries, mutations, etc.

**Parameters**:
- `space_id`: The ID of the space to get the schema for (required)

**Response**:
```json
{
  "space_id": "Space_Name",
  "sdl": "type Query { ... } type Mutation { ... } ..."
}
```

### validate_fibery_graphql

Validates a generated GraphQL query or mutation for Fibery against the known schema. Returns any validation errors.

**Parameters**:
- `space_id`: The ID of the space to validate against (required)
- `query_to_validate`: The GraphQL query or mutation to validate (required)

**Response**:
```json
{
  "valid": true,
  "errors": []
}
```

## License

MIT