EditorMcpService
Editor-owned native MCP dispatcher for Reckfell tools.
Editor-owned native MCP dispatcher for Reckfell tools.
Obtain this service through EditorInterface.GetMcpService. It shares the same commands between external MCP clients and the built-in AI panel. All object operations execute on the editor thread. Runtime and managed requests return job identifiers; observe EditorMcpService.GetJob before treating a submission as complete. The service is available only in editor builds and must not be instantiated by projects.
Declarations checked against C# SDK 1.0.0. Expand a name to see declarations and documentation.
Methods13
CheckedPathstring
public string CheckedPath(string path, bool write = false);Resolves a permitted project path, or returns an empty string for an out-of-scope path. Used by the shipped managed service.
| Name | Type | Default |
|---|---|---|
path | string | — |
write | bool | false |
stringCompleteJobvoid
public void CompleteJob(string id, Reckfell.Collections.Dictionary result);Completes an engine integration job on the editor thread. Late results after cancellation are ignored.
| Name | Type | Default |
|---|---|---|
id | string | — |
result | Reckfell.Collections.Dictionary | — |
ExecuteReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary Execute(string tool, Reckfell.Collections.Dictionary arguments);Executes a registered tool action. Returns an explicit success/error dictionary or a tracked job identifier. Must run on the main thread.
| Name | Type | Default |
|---|---|---|
tool | string | — |
arguments | Reckfell.Collections.Dictionary | — |
Reckfell.Collections.DictionaryGetJobReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary GetJob(string id);Returns a job state and its completed result.
| Name | Type | Default |
|---|---|---|
id | string | — |
Reckfell.Collections.DictionaryGetStatusReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary GetStatus();Returns URL, process and project identities, trust and managed-service status. Does not return credentials.
Reckfell.Collections.DictionaryGetToolsReckfell.Collections.Array
public Reckfell.Collections.Array GetTools(string query = "");Finds tool groups by name, description and action.
| Name | Type | Default |
|---|---|---|
query | string | "" |
Reckfell.Collections.ArrayIsTrustedbool
public bool IsTrusted();Reports the current editor-session trust decision.
boolNewJobstring
public string NewJob(string kind);Allocates an engine integration job.
| Name | Type | Default |
|---|---|---|
kind | string | — |
stringRestoreFileCheckpointReckfell.Collections.Dictionary
public Reckfell.Collections.Dictionary RestoreFileCheckpoint(string id);Engine integration rollback for a persisted checkpoint in this project. Checks hashes and unsaved editor state. Remains available to the shipped managed host after editing permission is revoked so cancellation can finish restoring its files. This method is not an external MCP tool.
| Name | Type | Default |
|---|---|---|
id | string | — |
Reckfell.Collections.DictionarySetManagedHandlervoid
public void SetManagedHandler(Callable handler);Registers the shipped managed editor service. Intended for engine integration.
| Name | Type | Default |
|---|---|---|
handler | Callable | — |
SetTrustedvoid
public void SetTrusted(bool trusted);Controls autonomous project edits. External MCP clients cannot change this through the tool catalog.
| Name | Type | Default |
|---|---|---|
trusted | bool | — |
StartServerError
public Error StartServer(int port = 0);Starts a bearer-authenticated loopback HTTP server. Zero chooses an unused port. Connection metadata is written to the project editor data directory with a Windows owner-only ACL.
| Name | Type | Default |
|---|---|---|
port | int | 0 |
ErrorStopServervoid
public void StopServer();Stops the HTTP worker and removes this editor's connection file.
Signals and events2
ActivityEvent
public event EditorMcpService.ActivityEventHandler Activity;Emitted after a dispatched command with action, status and sequence. Credentials and arguments are excluded.
| Name | Type | Default |
|---|---|---|
entry | Reckfell.Collections.Dictionary | — |
JobCompletedEvent
public event EditorMcpService.JobCompletedEventHandler JobCompleted;Emitted when a tracked operation completes or fails.
| Name | Type | Default |
|---|---|---|
id | string | — |
result | Reckfell.Collections.Dictionary | — |