# Schematica MCP Server

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for browsing, creating, and managing schema projects on the [Schematica](https://library.schematica.io/) schema library.

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "schematica": {
      "url": "https://go.coremodels.io/mcp"
    }
  }
}
```

### Cursor / VS Code

Add to `.cursor/mcp.json` or `.vscode/mcp.json`:

```json
{
  "servers": {
    "schematica": {
      "type": "streamable-http",
      "url": "https://go.coremodels.io/mcp"
    }
  }
}
```

## Authentication

Some tools work without authentication. Write tools require a `token` parameter — generate an API key from your project settings.

## Available Tools

### Read-Only

| Tool | Description |
|------|-------------|
| `schema_library_query_project` | Query and retrieve project details including metadata, classifications, and permissions |
| `schema_library_get_metadata_options` | Get all available metadata options (access methods, types, licenses, formats, domains, audiences, model sizes) |
| `schema_library_get_classifications` | Get all classification options for categorizing and tagging projects |
| `schema_library_projects_section` | Search and browse projects with advanced filtering, pagination, and sorting |
| `schema_library_get_use_case_types` | Get available use case types for schema projects |

### Write

| Tool | Description |
|------|-------------|
| `schema_library_create_project` | Create a new schema library project |
| `schema_library_update_project` | Update an existing project's data, metadata, and classifications |
| `schema_library_update_use_cases` | Add new use cases and/or remove existing use cases from a project |

## Usage Examples

**Browse the library:**
> "Search for schema projects related to healthcare interoperability."

**Explore a project:**
> "Show me the details and classifications of project abc123."

**Create a new schema project:**
> "Create a new schema library project for a FHIR Patient resource model."

## Links

- [Schematica](https://schematica.io)
- [Aramai](https://www.aramai.net/)