How do I use Genesis-World-MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Genesis-World-MCP search for contacts with name John" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

Genesis-World-MCP

by Gnidreve

Overview Schema Related Servers Score Discussions

TypeScript

Remote

cas-genesisworld-mcp

npm Docker License: MIT

Connect Claude, Cursor, or any MCP-compatible AI agent to your CAS genesisWorld CRM. Search contacts, manage tasks and appointments, and read or write records — through natural language, without writing a single API call.

69 tools, including 7 native flows that bundle multi-step CRM operations (like checking for scheduling conflicts before booking a meeting, or checking for duplicates before creating a contact) into a single call.
Full read/write access to tasks, contacts, appointments, documents, distribution lists, and more — plus generic access to any custom object type your installation defines.
Read-only mode available for safe, exploratory use.
Ships as a ready-made Docker image or npm package.

Quick start

Add this to your MCP client's config (e.g. Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "cas-genesisworld": {
      "command": "npx",
      "args": ["-y", "cas-genesis-world-mcp"],
      "env": {
        "GENESISWORLD_BASE_URL": "http://your-genesisworld-server/genesisrest.svc",
        "GENESISWORLD_PRODUCT_KEY": "your-product-key",
        "GENESISWORLD_USERNAME": "your-username",
        "GENESISWORLD_PASSWORD": "your-password"
      }
    }
  }
}

Restart your client — the tools show up automatically. Ask your agent to find a contact, list your open tasks, or book a meeting, and it takes it from there.

Prefer a persistent, self-hosted server instead of a per-client process? See Self-hosting with Docker below.

Related MCP server: Cleyrop MCP

What you can ask it

Once connected, your agent can handle requests like:

"Find the contact info for Jane Doe and show me her open tasks."
"Create a follow-up task for this lead and link it to their contact record."
"Book a meeting with the sales team next Tuesday at 10am — check everyone's calendar for conflicts first."
"Check for possible duplicates before creating a new contact for Acme Corp."
"Generate a report for this opportunity."

Requests like these are answered by flows — single tool calls that bundle the multi-step sequence of API requests a human would otherwise have to script by hand.

Tools & flows

Flows — compound actions, one call each

Flow	Mode	What it does
`my_open_tasks`	read	Current user + their task list (due window, saved view, or full-text filter) in one call
`task_overview`	read	Task record + links + tags, fetched in parallel
`create_task`	write	Create a task and optionally link it to another object (e.g. a contact)
`find_contact`	read	Contact search by name and/or phone number, in parallel
`contact_360`	read	Contact + collection dossier + tags + links, fetched in parallel
`create_address_safe`	write	Duplicate check first — creates only when no candidates are found
`create_appointment_safe`	write	Optional conflict check → create → add participants, in one call

Read (39)

Tool	Endpoint
`smart_search`	`GET /v7.0/smartsearch`
`get_data_object`	`GET /v7.0/type/{dataObjectType}/{dataObjectGGUID}`
`get_dossier`	`GET /v7.0/type/{dataObjectType}/{dataObjectGGUID}/dossier/full`
`list_data_objects`	`GET /v7.0/type/{dataObjectType}/list`
`list_views`	`GET /v7.0/type/{dataObjectType}/view/list`
`list_data_objects_by_view`	`GET /v7.0/type/{dataObjectType}/view/{viewID}/list`
`list_available_data_object_types`	`GET /v7.0/user/self/dataobjecttypepermission/list`
`get_data_object_types_metadata`	`GET /v7.0/metadata`
`list_links`	`GET /v7.0/type/{dataObjectType}/{dataObjectGGUID}/link/list`
`list_recent_data_objects`	`GET /v7.0/type/{dataObjectType}/recent/list`
`get_available_products`	`GET /v7.0/type/gwopportunity/availableproducts`
`get_data_object_count`	`GET /v7.0/type/{dataObjectType}/count`
`get_primary_link_parents`	`GET /v7.0/type/{dataObjectType}/{dataObjectGGUID}/primarylinkparents`
`list_users`	`GET /v7.0/user/list`
`get_user_self`	`GET /v7.0/user/self`
`get_view`	`GET /v7.0/type/{dataObjectType}/view/{viewID}`
`list_tags`	`GET /v7.0/tags`
`get_object_tags`	`GET /v7.0/type/{dataObjectType}/{dataObjectGGUID}/tags`
`get_full_data_objects`	`GET /v7.0/type/{dataObjectType}/full`
`list_data_objects_by_view_full`	`GET /v7.0/type/{dataObjectType}/view/{viewID}/full`
`get_data_objects_bulk`	`POST /v7.0/type/{dataObjectType}/records` (read despite POST)
`get_ticket_service_agreements`	`GET /v7.0/type/task/ticket/serviceagreements`
`get_vcard`	`GET /v7.0/type/address/{dataObjectGGUID}/vcard`
`get_salutation`	`POST /v7.0/type/address/salutation` (read despite POST)
`format_phone_number`	`POST /v7.0/type/address/formatphonenumber` (read despite POST)
`check_appointment_conflicts`	`GET /v7.0/type/appointment/conflicts`
`get_participant_summary`	`GET /v7.0/type/appointment/{gguid}/participant/summary`
`list_appointment_participants`	`GET /v7.0/type/appointment/{gguid}/participant/full`
`get_document_file`	`GET /v7.0/type/document/{gguid}/file` (never locks)
`list_document_versions`	`GET /v7.0/type/document/{gguid}/file/version/list`
`list_email_attachments`	`GET /v7.0/type/emailstore/{gguid}/attachment/list`
`get_email_attachment`	`GET /v7.0/type/emailstore/{gguid}/attachment/{attachmentId}`
`get_email_file`	`GET /v7.0/type/emailstore/{gguid}/file`
`list_object_permissions`	`GET /v7.0/type/{t}/{gguid}/permission/full`
`list_distributions`	`GET /v7.0/type/gwdistribution/list`
`list_distribution_addresses`	`GET /v7.0/type/gwdistribution/{distributionGuid}/address/list`
`list_report_templates`	`GET /v7.0/type/report/template/{templateType}`
`generate_report`	`POST /v7.0/type/report/template/{templateGGUID}` (read despite POST — renders, doesn't mutate)
`readme` (tool form)	server-local static orientation document

Write (23 — hidden in read-only mode, along with the write flows above)

Tool	Endpoint
`create_data_object`	`POST /v7.0/type/{dataObjectType}`
`update_data_object`	`PUT /v7.0/type/{dataObjectType}/{dataObjectGGUID}`
`delete_data_object`	`DELETE /v7.0/type/{dataObjectType}/{dataObjectGGUID}`
`restore_data_object`	`POST /v7.0/type/{dataObjectType}/rbin/undelete`
`create_link`	`POST /v7.0/type/{dataObjectType}/{dataObjectGGUID}/link`
`delete_link`	`DELETE /v7.0/type/{t}/{gguid}/link/{objecttype2}/{guid2}/{attribute}`
`set_object_tags`	`POST /v7.0/type/{dataObjectType}/{dataObjectGGUID}/tags/user`
`append_notes`	`POST /v7.0/type/{t}/{gguid}/notes/{fieldName}`
`create_dossier_entry`	`POST /v7.0/type/{dataObjectType}/{dataObjectGGUID}/dossier`
`delete_dossier_entry`	`DELETE /v7.0/type/{t}/{gguid}/dossier/{dossierEntryGGUID}`
`set_contact_persons_active`	`POST /v7.0/type/address/{gguid}/contactperson/activate\|deactivate`
`add_appointment_participant`	`POST /v7.0/type/appointment/{gguid}/participant`
`remove_appointment_participant`	`DELETE /v7.0/type/appointment/{gguid}/participant/{participantGGUID}`
`set_recurrence`	`POST /v7.0/type/{t}/recurrence` / `PUT …/recurrence/{periodGuid}`
`delete_recurrence`	`DELETE /v7.0/type/{t}/recurrence/{periodGuid}`
`set_alarm`	`PUT /v7.0/type/{t}/{gguid}/alarm/self`
`delete_alarm`	`DELETE /v7.0/type/{t}/{gguid}/alarm/self`
`set_object_permission`	`POST /v7.0/type/{t}/{gguid}/permission`
`delete_object_permission`	`DELETE /v7.0/type/{t}/{gguid}/permission/{permissionGGUID}`
`add_distribution_addresses`	`POST /v7.0/type/gwdistribution/{distributionGuid}/address`
`remove_distribution_address`	`DELETE /v7.0/type/gwdistribution/{distributionGuid}/address/{addressGGUID}`
`convert_lead`	`POST /v7.0/type/gwsllead/{dataObjectGGUID}/convert`
`recalculate_opportunity_positions`	`PUT /v7.0/type/gwopportunitypos/recalculatevalues`

The full upstream API this is built on is committed as swagger.json.

Resources

Beyond tools, the server exposes MCP resources for data that rarely changes, so your agent doesn't burn tool calls rediscovering it every session:

genesisworld://readme — static orientation document for the agent itself (domain model, navigation patterns, efficiency rules).
genesisworld://types — data-object types accessible to the user, with permissions. Cached 15 min.
genesisworld://metadata/{objectType} — field/relationship schema of one type, e.g. genesisworld://metadata/ADDRESS. Cached 15 min.
genesisworld://views/{objectType} — saved views of one type, e.g. genesisworld://views/TASK. Cached 15 min.

Self-hosting with Docker

For a persistent server multiple clients can point at (instead of one npx process per client):

docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
  -e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
  -e GENESISWORLD_PRODUCT_KEY="your-product-key" \
  -e GENESISWORLD_USERNAME="your-username" \
  -e GENESISWORLD_PASSWORD="your-password" \
  vaatu/cas-genesis-world-mcp

# Read-only mode: append --read-only after the image name
docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
  -e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
  -e GENESISWORLD_PRODUCT_KEY="your-product-key" \
  -e GENESISWORLD_USERNAME="your-username" \
  -e GENESISWORLD_PASSWORD="your-password" \
  vaatu/cas-genesis-world-mcp --read-only

Multi-tenant: one server, many genesisWorld identities

By default the container has one fixed genesisWorld identity for every client that connects. With --client-credentials, it has none — each client authenticates itself, so one server can safely serve several people/teams with different genesisWorld logins:

docker run -d --name cas-genesisworld-mcp -p 8084:3000 \
  -e GENESISWORLD_BASE_URL="http://your-genesisworld-server/genesisrest.svc" \
  vaatu/cas-genesis-world-mcp --client-credentials

Each client then sends its own credentials as headers when connecting:

{
  "mcpServers": {
    "cas-genesisworld": {
      "url": "http://localhost:8084/mcp",
      "headers": {
        "X-GenesisWorld-Username": "your-username",
        "X-GenesisWorld-Password": "your-password"
      }
    }
  }
}

X-GenesisWorld-Product-Key is optional here — if you keep GENESISWORLD_PRODUCT_KEY set on the server, clients that omit their own product key fall back to it. HTTP transport only (there's no per-request header channel on stdio); a request missing both username and password headers is rejected outright (HTTP 401), it never falls back to a shared identity.

The MCP endpoint is now at http://localhost:8084/mcp. Point your client at it:

{
  "mcpServers": {
    "cas-genesisworld": {
      "url": "http://localhost:8084/mcp"
    }
  }
}

Configuration

Two kinds of settings, kept strictly separate — no setting is both: Environments configure the deployment (where the API lives, who connects); launch options toggle behavior at startup.

Environments

Variable	Required	Purpose
`GENESISWORLD_BASE_URL`	yes	Base URL of the REST service, e.g. `http://demo.cas.de/genesisrest.svc`
`GENESISWORLD_PRODUCT_KEY`	yes*	Sent as `X-CAS-PRODUCT-KEY` on every request
`GENESISWORLD_USERNAME`	yes*	Basic Auth user
`GENESISWORLD_PASSWORD`	yes*	Basic Auth password
`MCP_TRANSPORT`	no	`http` (default in Docker) or `stdio`
`MCP_HOST` / `MCP_PORT`	no	Bind address for HTTP mode (default `0.0.0.0:3000`)
`GENESISWORLD_MAX_RESULT_CHARS`	no	Truncate oversized responses (default 60000 chars; `0` disables)
`GENESISWORLD_QUIET`	no	`true` disables per-request stderr logging

* Required in practice for any real request to succeed — except in --client-credentials mode (see below), where the server has no identity of its own and none of these three are required.

Launch options

Flag	Required	Purpose
`--read-only`	no	Registers only read tools for that session — mutating tools are not merely blocked, they don't exist
`--client-credentials`	no	Server holds no fixed genesisWorld identity; each HTTP client authenticates itself via request headers (see "Multi-tenant" above). HTTP transport only

Pass launch options on the command line, or after the image name in docker run (as shown above). None of them have an environment-variable equivalent, by design.

License

MIT

Want to add a tool or understand how this is built? See AGENTS.md for architecture and contributor docs, and ROADMAP.md for the project plan.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

license - permissive license

Not graded

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

6dRelease cycle

2Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

mcp-daktela
Customer Support Communication CRM
hajekd
A
license
A
quality
C
maintenance
Read-only MCP server for the Daktela contact center REST API, providing 40 tools to access tickets, calls, emails, chats, contacts, CRM records, campaigns, and real-time agent status.
Updated 6 months ago (2026-02-23 22:08 UTC)
45
1
MIT
Cleyrop MCP
File Systems Search Data Platforms
MartinCley
F
license
Not graded
quality
C
maintenance
MCP server to interact with Cleyrop work data: browse, search, read file content, and manage files/folders.
Updated 2 months ago (2026-06-18 11:45 UTC)
zoho-crm-mcp
CRM Databases
5ivatej
F
license
Not graded
quality
C
maintenance
Provides live Zoho CRM data access via MCP tools, enabling queries on modules, records, fields, and related lists without syncing data.
Updated 2 months ago (2026-06-22 18:58 UTC)
Twenty CRM MCP
CRM Project Management
0xfabrica
A
license
A
quality
B
maintenance
Enables MCP clients to read, search, create, update, and manage records in Twenty CRM with a safe, composable 14-tool interface and guarded destructive operations.
Updated 19 days ago (2026-08-12 21:10 UTC)
14
MIT

View all related MCP servers

Related MCP Connectors

One
Search, document and execute authenticated API calls across 700+ apps via one MCP server
classquill-mcp
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
xfa
XFA's remote MCP server — query device posture, compliance, policies & CVEs. Read-only.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Gnidreve/Genesis-World-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

cas-genesisworld-mcp

Quick start

What you can ask it

Tools & flows

Flows — compound actions, one call each

Read (39)

Write (23 — hidden in read-only mode, along with the write flows above)

Resources

Self-hosting with Docker

Multi-tenant: one server, many genesisWorld identities

Configuration

Environments

Launch options

License

Maintenance

Resources

Looking for Admin?

Related MCP Servers

mcp-daktela

Cleyrop MCP

zoho-crm-mcp

Twenty CRM MCP

Related MCP Connectors

Latest Blog Posts

MCP directory API