README.md
MCP server for the ConFd museums, organizations, and conferences API.
@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
Tools (18)
list_museumsSearch and filter museums by name, country, source, tag, published/discarded statusget_museumGet a museum by IDcreate_museumCreate a new museumupdate_museumUpdate a museum by IDupsert_museumCreate or update a museum by source identifierupload_museum_logoUpload a logo (from URL, base64, or file path)delete_museum_logoRemove a museum's logolist_organizationsSearch and filter organizationsget_organizationGet an organization by IDcreate_organizationCreate a new organizationupdate_organizationUpdate an organization by IDupsert_organizationCreate or update by source identifierupload_organization_logoUpload a logodelete_organization_logoRemove an organization's logolist_conferencesSearch and filter conferences by name, country, organization, tag, scopeget_conferenceGet a conference by IDcreate_conferenceCreate a new conference with dates, venue, registration infoupdate_conferenceUpdate a conference by IDEnvironment Variables
CONFD_API_URLrequiredThe base URL for the ConFd APICONFD_API_KEYrequiredThe API key for authenticating with ConFdConfiguration
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"}}}}Try it
→List all museums located in France that are currently published.
→Create a new organization entry for the City Art Gallery.
→Find upcoming conferences related to digital art.
→Upload a new logo for the museum with ID 12345.
→Update the registration information for the annual tech conference.