@stqry/confd-mcp

MCP server for the ConFd museums, organizations, and conferences API.

Install

npm install -g @stqry/confd-mcp

You'll need a ConFd API key. Set these environment variables:

export CONFD_API_URL="https://confd.stqry.com/api/v1"
export CONFD_API_KEY="your-api-key"

Setup

Claude Code

claude mcp add confd -- npx -y @stqry/confd-mcp

Then set the environment variables in your shell before launching Claude Code, or add them to your shell profile.

Claude Desktop

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "confd": {
      "command": "npx",
      "args": ["-y", "@stqry/confd-mcp"],
      "env": {
        "CONFD_API_URL": "https://confd.stqry.com/api/v1",
        "CONFD_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "confd": {
      "command": "npx",
      "args": ["-y", "@stqry/confd-mcp"],
      "env": {
        "CONFD_API_URL": "https://confd.stqry.com/api/v1",
        "CONFD_API_KEY": "your-api-key"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "confd": {
      "command": "npx",
      "args": ["-y", "@stqry/confd-mcp"],
      "env": {
        "CONFD_API_URL": "https://confd.stqry.com/api/v1",
        "CONFD_API_KEY": "your-api-key"
      }
    }
  }
}

Tools (18)

Museums

Tool	Description
`list_museums`	Search and filter museums by name, country, source, tag, published/discarded status
`get_museum`	Get a museum by ID
`create_museum`	Create a new museum
`update_museum`	Update a museum by ID
`upsert_museum`	Create or update a museum by source identifier
`upload_museum_logo`	Upload a logo (from URL, base64, or file path)
`delete_museum_logo`	Remove a museum's logo

Organizations

Tool	Description
`list_organizations`	Search and filter organizations
`get_organization`	Get an organization by ID
`create_organization`	Create a new organization
`update_organization`	Update an organization by ID
`upsert_organization`	Create or update by source identifier
`upload_organization_logo`	Upload a logo
`delete_organization_logo`	Remove an organization's logo

Conferences

Tool	Description
`list_conferences`	Search and filter conferences by name, country, organization, tag, scope (upcoming/past)
`get_conference`	Get a conference by ID
`create_conference`	Create a new conference with dates, venue, registration info
`update_conference`	Update a conference by ID

Development

npm install
npm run dev    # Watch mode
npm run build  # Production build
npm start      # Run the server

confd-mcp