# Nex.Ai

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add nexai/developer

# Browse available tools
npx -y @smithery/cli@latest tool list nexai/developer

# Get full schema for a tool
npx -y @smithery/cli@latest tool get nexai/developer create_record

# Call a tool
npx -y @smithery/cli@latest tool call nexai/developer create_record '{}'
```

## Direct MCP Connection

Endpoint: `https://developer--nexai.run.tools`

**Optional config:**
- `nex-api-key` (header) — Nex API key

## Tools (57)

- `create_record` — Create a new record for an object type. Use only when you have clean, structured data with known attribute slugs. For u…
- `upsert_record` — Create a record if it doesn't exist, or update it if a match is found on the specified attribute. Useful for deduplicat…
- `get_record` — Retrieve a specific record by its ID, including all its attributes.
- `update_record` — Update specific attributes on an existing record. Only the provided attributes are changed.
- `delete_record` — Permanently delete a record. This cannot be undone.
- `list_records` — List records for an object type with optional filtering, sorting, and pagination.
- `search_records` — Search records by name across all object types (person, company, deal, etc.). Returns matches grouped by object type wi…
- `query_context` — Query the Nex context graph with a natural language question. Returns an AI-generated answer with supporting entities a…
- `add_context` — Ingest unstructured text (meeting notes, emails, conversation transcripts) into the Nex context graph. Automatically ex…
- `get_artifact_status` — Check the processing status and results of a previously submitted text artifact. Poll until status is 'completed' or 'f…
- `create_list_job` — Create an AI-powered list generation job. Uses natural language to search the context graph and generate a curated list…
- `get_list_job_status` — Check the status and results of an AI list generation job. Poll until status is 'completed' or 'failed'. Returns matche…
- `search_entities` — Search for entities (people, companies, topics) in the Nex knowledge base. Returns a structured list with names, types,…
- `create_object` — Create a new custom object type definition (e.g. 'Project', 'Deal'). Defines the schema for a new entity type in your w…
- `get_object` — Get a single object type definition with its attributes. Use this to discover available fields before creating or query…
- `list_objects` — List all object type definitions in the workspace. Call this first to discover available object types and their schemas…
- `update_object` — Update an existing object type definition (name, description, plural name).
- `delete_object` — Delete an object type definition and ALL its records. This is destructive and cannot be undone.
- `create_attribute` — Add a new attribute (field) to an object type. Supports types: text, number, email, phone, url, date, boolean, currency…
- `update_attribute` — Update an existing attribute definition on an object type.
- `delete_attribute` — Delete an attribute from an object type. This removes the field and its data from all records. Cannot be undone.
- `create_relationship_definition` — Define a new relationship type between two object types (e.g. person 'works at' company).
- `list_relationship_definitions` — List all relationship type definitions in the workspace.
- `delete_relationship_definition` — Delete a relationship type definition. This removes all instances of this relationship. Cannot be undone.
- `create_relationship` — Link two records using an existing relationship definition.
- `delete_relationship` — Remove a relationship between two records. Cannot be undone.
- `list_object_lists` — Get all lists associated with an object type.
- `create_list` — Create a new list under an object type.
- `get_list` — Get a list definition by ID.
- `delete_list` — Delete a list definition. Cannot be undone.
- `add_list_member` — Add an existing record to a list with optional list-specific attributes.
- `upsert_list_member` — Add a record to a list, or update its list-specific attributes if already a member.
- `list_list_records` — Get paginated records from a specific list.
- `update_list_record` — Update list-specific attributes for a record within a list.
- `delete_list_record` — Remove a record from a list. The record itself is not deleted.
- `create_task` — Create a new task, optionally linked to records and assigned to users.
- `list_tasks` — List tasks with optional filtering by record, assignee, completion status, or search query.
- `get_task` — Get a single task by ID.
- `update_task` — Update a task's fields. All fields are optional -- only provided fields are changed.
- `delete_task` — Archive a task (soft delete). Cannot be undone via API.
- `create_note` — Create a new note, optionally linked to a record.
- `list_notes` — List notes, optionally filtered by associated record. Returns up to 200 notes.
- `get_note` — Get a single note by ID.
- `update_note` — Update a note's fields. All fields are optional -- only provided fields are changed.
- `delete_note` — Archive a note (soft delete). Cannot be undone via API.
- `get_record_timeline` — Get paginated timeline events for a record (tasks, notes, attribute changes, etc.).
- `get_insights` — Query insights by time window. Returns discovered opportunities, risks, relationship changes, milestones, and other ins…
- `list_integrations` — List all available third-party integrations and their connection status. Calendar integrations (Google Calendar, Outloo…
- `connect_integration` — Start connecting a third-party integration via OAuth. Returns an auth_url to open in the browser and a connect_id to po…
- `get_connect_status` — Check the status of an in-progress OAuth connection. Poll this after connect_integration until status is 'connected'.
- `disconnect_integration` — Disconnect a third-party integration by connection ID. Get connection IDs from list_integrations.
- `get_notifications` — List recent notification feed items. Returns context alerts with important items and entity changes that were generated…
- `get_notification_preferences` — Get current notification preferences: polling frequency, enabled notification types, and digest settings.
- `set_notification_preferences` — Update notification preferences: polling frequency, enabled types, or digest settings.
- `create_notification_rule` — Create a custom AI notification rule. Describe what you want to be notified about in natural language, e.g. 'notify me …
- `list_notification_rules` — List all custom notification rules you have set up.
- `delete_notification_rule` — Delete a custom notification rule by ID.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get nexai/developer <tool-name>
```