@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